Xcode 运行 于 苹果 公司 的 Mac 操 作 系 统 下 ， 是 革 果 公司 向 开发 人 员 提 供 的 集成 开发 环境 ,主要 用 于 开发 Mac OS X 和 iOS 应 用 程 
序 。 之 前 基本 上 只 有 Mac OS XX 应 用 的 开发 才 会 用 到 Xcode， 所 以 它 一 直 很 小 众 ， 处 于 默默 无 闻 的 状态 。 随 着 移动 设备 的 普及 ， 移 
动 应 用 的 开发 也 越 来 越 火 热 ，iPhone 占 据 了 智能 机 市 场 的 重要 地 位 ， 越 来 越 多 的 开发 人 员 开 始 加 入 iPhone 应 用 程序 开发 的 阵营 。 
从 Xcode 3.1 开 始 ， 它 也 可 作为 OS 的 开发 环境 ， 所 以 Xcode 也 随 之 进入 了 移动 开发 人 员 的 日 常 工作 中 。 


本 书 深入 浅 出 地 介绍 了 Xcode 6 的 使 用 ， 作 者 根据 自己 丰富 的 Apple 平 台 开 发 经 验 ， 通 过 3 个 示例 程序 ， 分 别 介 绍 了 命令 行 开 
~ iPhone app 开 发 和 Mac app 开 发 的 最 佳 流 程 ， 在 这 些 开发 流程 中 ， 详 细 介 绍 了 Xcode 6 的 各 项 功能 。 示 例 程 序 全 部 用 最 新 的 Swift 
语言 编写 。 通 过 阅读 本 书 ， 你 可 以 掌握 Xcode 6 的 使 用 方法 和 常见 功能 。 熟 练 使 用 Xcode 6 的 各 项 功能 可 以 极 大 地 提高 工作 效率 。 


自从 支持 iDOS 开 发 后 ，Xcode 的 更 新 速度 也 加 快 了 许多 。 每 次 都 和 iOS 的 新 版 本 一 起 发 布 ， 翻 译 完 本 书 的 时 候 ， 蔷 果 公 司 在 
WWDC 2015 上 刚刚 发 布 了 Xcode 7。Xcode 7 最 大 的 特性 就 是 支持 Swift 2.0 和 可 以 不 用 加 入 付费 开发 者 计划 就 能 在 真 机 上 调 武 ， 极 
大 地 方便 了 开发 者 。 而 有 全， 革 果 公司 在 WWDC 上 声称 之 后 会 将 Swift 开源 ， 这 将 会 极 大 地 促进 Swift 社区 的 发 展 ， 本 书 中 的 示例 程 
序 都 用 Swift 语 言 重 新 编写 称 得 上 是 明智 之 举 。 书 中 介绍 的 各 个 特性 基本 都 适用 于 Xcode 7， 所 以 读者 不 必 担 心 内 容 过 时 的 问题 。 


本 书 内 容 翔 实 ， 循 序 渐进 ， 履 盖 了 从 项 目 初始 到 项 目 发 布 流程 中 涉及 的 Xcode 功 能 ， 既 可 以 作为 经 验 丰 富 的 开发 人 员 的 参考 
手册 ， 也 可 以 作为 新 手 开发 人 员 的 入 门 指引 书籍。 


鉴于 译 者 水 平 有 限 ， 书 中 难免 有 差强人意 的 地 方 ， 欢 迎 广大 读者 批评 指正 。 


欢迎 阅读 本 书 。 本 书 将 展示 如 何 使 用 Apple 的 集成 开发 环境 在 进行 高 质量 产品 开发 的 过 程 中 达到 事半功倍 的 效果 。 


Xcode 6 是 一 个 开发 工具 家 族 的 后 裔 ， 这 些 开 发 工具 最 早 可 以 追溯 到 20 年 前 NeXT 的 PtojectBuilder。 它 最 初 是 一 个 集 文本 编辑 
器 、 用 户 界 面 设计 器 和 UNIX 前 端 开发 为 一 体 的 工具 集 。 现 在 Xcode 6 已 经 发 展 成 为 一 个 复杂 的 系统 ， 用 于 构建 应 用 程序 和 系统 软 
件 。 它 充分 利用 了 全 面 的 索引 系统 和 精确 的 增 量 解析 器 的 功能 ， 可 以 用 来 帮助 你 在 项 目 中 集成 正确 的 代码 ， 并 一 次 性 让 这 些 代 码 
执行 成 功 。 

这 种 强大 的 功能 会 让 人 望 而 生 晴 。 本 书 旨 在 揭 开 Xcode 的 神秘 面纱 ， 通 过 一 些 案例 用 循序 渐进 的 方式 展示 如 何在 日 常 工作 中 
使 用 它 。 不 要 被 一 般 的 方法 蒙蔽 了 双眼 : 本 书 将 会 揭示 Xcode 完整 开发 流程 的 最 佳 实践 。 本 书 不 涵盖 “高 级 话题 ”， 我 会 在 开发 
过 程 的 恰当 时 机 介绍 版 本 控制 和 单元 测试 相关 的 内 容 。 


本 书 的 组 织 方 式 


首先 ， 对 我 的 计划 进行 一 个 整体 概括 : 这 是 一 本 关于 开发 者 工具 的 书 。 如 果 它 教会 了 你 如 何 使 用 Cocoa 框 架 或 者 一 些 关于 编 
程 的 知识 ， 那 也 不 错 ， 不 过 这 些 内 容 都 是 用 来 介绍 Xcode 工作 流程 所 附带 的 内 容 。 学 习 各 种 框架 有 众多 优秀 的 书籍 和 资源 ， 在 附 


录 B 中 你 可 以 找到 大 量 这 类 资源 。 


每 一 段 旅程 都 需要 有 一 条 路 线 ， 同 样 每 一 堂 课 都 需要 一 个 故事 作为 引线 。 本 书 前 3 部 分 通过 3 个 应 用 程序 来 介绍 Xcode， 这 3 
个 程序 是 : 一 个 命令 行程 序 、 一 个 1OS 应 用 程序 以 及 一 个 OS X 应 用 程序 ， 它 们 的 功能 是 计算 和 展示 美国 橄榄 球 比 赛 中 的 部 分 统计 


些 应 用 程序 都 不 实用 ， 图 形 应 用 几乎 全 部 基于 示例 数据 。 但 是 在 这 3 个 应 用 程序 的 制作 过 程 中 ， 需 要 用 到 很 多 开发 工 


Xcode 支持 一 些 技术 ， 如 : Core Data 和 OS XJ Æ (binding) ， 这 些 技 术 都 不 是 针对 入 门 读者 的 。 本 书 直 接 深 入 这 些 技术 内 
部 ， 急 略 了 从 概念 上 讲 更 简单 的 方法 ， 这 样 我 可 以 解释 清楚 Xcode 的 工作 原理 。 其 他 一 些 “ 高 级 ”技术 ， 比 如 单元 测试 和 版 本 控 
制 ， 都 会 在 实践 中 需要 它们 的 时 候 才 会 介绍 。 这 就 是 Xcode 支持 的 工作 流程 。 


第 二 部 分 和 第 三 部 分 分 别 使 用 1OS 和 OS X 应 用 程序 作为 示例 程序 ， 即 使 你 仅 对 其 中 一 个 平台 感 兴趣 ， 也 应 该 阅读 另外 一 个 平 
台 对 应 的 内 容 。 这 些 应 用 程序 的 制作 不 过 是 一 个 引子 ， 相 应 的 技术 两 个 平台 都 适用 。 


第 一 部 分 会 介绍 Xcode 的 安装 ， 然 后 通过 一 些 基 本 的 调试 技巧 运行 第 一 个 项 目 。 你 将 会 完成 一 个 小 型 的 命令 行 应 用 程序 。 这 
4 


个 应 用 程序 可 能 很 简单 ， 但 是 你 会 学 到 在 制作 复杂 的 图 形 应 用 程序 之 前 必 备 的 一 些 基本 技术 。 





第 1 章 ， 获 取 Xcode 下 载 Xcode 6 之 前 需要 考虑 的 一 些 问 题 ， 两 种 下 载 和 安装 方法 。 





第 2 章 ， 初 识 Xcode ni I Xcode, -Ahh AHH 





第 3 草 ， 简 单 的 工作 流程 和 被 动 调试 、 构 建 并 运行 一 个 简单 的 应 用 程序 ， 再 对 崩 江 做 出 处 理 。 





第 4 章 ， 主 动 调试 在 程序 中 设置 断 点 (breakpoint) 和 追踪 (tracing) 来 负责 调试 。 该 章 会 展示 如 何 组 织 工 作 空 间 


(workspace) 。 


se 


第 5 草 ， 编 译 





停 下 来 介绍 应 用 程序 的 构建 流程 。 





第 6 章 ， 添 加 库 target 一 一 在 项 目 中 添加 一 个 库 target， 然 后 学 习 如 何 从 多 个 目标 (target) 构建 产品 。 


第 7 草 ， 版 本 控制 一 一 揭示 为 什么 源 代码 管理 这 么 重要 ， 如 何 通 过 Git 和 Subversion 充 分 利用 Xcode 内 置 的 版 本 管理 。 


iO0S 应 用 程序 的 生命 周期 


第 二 部 分 介绍 一 个 小 型 Phone 应 用 程序 ， 以 及 如 何 使 用 Apple 开 发 者 工具 构建 这 个 应 用 程序 。 它 会 引领 你 使 用 图 形 编辑 器 制 
作用 户 界 面 ， 展 示 如 何 配置 应 用 程序 以 优化 应 用 程序 的 速度 和 内 存 负荷 。 


第 8 章 ， 开 始 制 作 1OS 应 用 程序 一 一 从 创建 一 个 1OS 项 目 开 始 ， 学 习 iOS Cocoa 框 架 中 的 模型 - 视图 - 控制 器 (Model-View- 


Controller) 设计 思想 ， 这 个 思想 也 适用 于 OS X. 


第 9 章 ，iOS 应 用 程序 : 模型 一 一 设计 一 个 Core Data 计 划 (schema) ， 并 在 自己 的 代码 中 支持 它 。 





第 10 章 ，iOS 应 用 程序 : 控制 器 创建 一 个 将 模型 与 界面 视图 链接 在 一 起 的 控制 器 。 同 时 ， 该 章 会 讲解 有 关 重 构 以 及 
Xcode 持续 错误 检查 的 知识 。 


第 11 章 ， 构 建新 视图 一 一 使 用 集成 在 Xcode 中 的 Interface Buildet 为 应 用 程序 设计 用 户 界 面 视 图 ， 充 分 利用 源 代 码 的 自动 补 全 


第 12 章 ， 新 视图 的 自动 布局 一 一 在 Xcode 6 中 ， 自 动 布局 (Autolayout) 更 多 的 是 帮助 完成 工作 而 不 是 与 工具 做 斗争 。 学 习 如 
何 运用 Cocoa 布 局 得 到 你 想 要 的 效果 。 


第 13 章 ， 添 加 表格 单元 格 一 一 当 向 应 用 程序 添加 一 个 界面 内 组 件 (in-screen component) 的 时 候 ， 你 将 会 调试 内 存 管理 ， 并 


通过 Scheme 编 辑 器 控制 Xcode 对 应 用 程序 的 编译 、 运 行 以 及 测试 过 程 。 





第 14 章 ， 添 加 编辑 器 添加 一 个 编辑 器 视图 ， 深 入 学 习 Storyboard。 





第 15 草 ， 单 元 测试 


中 头等 重要 的 部 分 的 。 


单元 测试 会 加 快 开 发 进程 并 让 应 用 程序 更 稳定 。 该 章 将 会 介绍 Xcode 是 如 何 将 单元 测试 作为 开发 过 程 


第 16 章 ， 度 量 和 分 析 一 一 使 用 Instruments 追 踪 性 能 和 内 存 问 题 。 





第 17 章 ，iOS 扩 展 一 一 创建 一 个 系统 级 别 的 扩展 和 共享 库 ， 提 升 应 用 程序 的 价值 。 


第 18 章 ， 配 置 一 一 完成 开发 后 ， 获 取 Apple 的 许可 让 应 用 程序 运行 在 Apple 设 备 上 的 流程 复杂 且 易 变 。 该 章 将 会 介绍 如 何 使 用 
Xcode 减 少 绝 大 部 分 及 烦 ， 并 给 出 一 些 避 免 陷 阱 的 小 技巧 。 


Mac OS X 开 发 中 的 Xcode 


第 三 部 分 将 焦点 转移 到 OS X 开 发 上 。 有 一 些 概念 在 ODS X 中 比 在 iDS 中 更 重要 ， 不 过 你 也 会 学 到 一 些 与 开发 平台 无 关 的 技 
术 。 


第 19 章 ， 开 始 制作 OS X 应 用 程序 一 一 将 iIOS 组 件 移植 到 OS XE; 介绍 什么 是 响应 链 (responder chain) ， 以 及 Inhtetface Builder 
如 何 让 它 更 易 于 使 用 o 


第 20 章 ， 绑 定 : 连接 OS X 应 用 程序 一 一 当 构 建 一 个 弹出 窗口 (popover window) 的 时 候 ， 你 将 会 使 用 OS X 绑 定 来 简化 数据 
与 界面 之 间 的 链接 。 你 还 会 使 用 目 动 调 整 大 小 的 功能 ， 这 是 一 种 布局 视图 结构 的 传统 技术 。 


第 21 章 ， 本 地 化 





如 何 将 Mac 和 iOS 应 用 程序 翻译 成 其 他 语言 。 





第 22 章 ， 程 序 包 


与 操作 系统 相 匹 配 。 


你 将 会 掌握 大 部 分 Mac 和 iOS 产 品 的 基本 结构 ， 以 及 在 这 两 个 平台 上 ， 如 何 使 用 Info.plist 文 件 将 应 用 程序 


第 23 章 ， 属 性 列表 一 一 学 习 基 本 的 类 JSON 的 文件 类 型 ， 用 于 在 OS X 和 iOS 平 台 上 存储 数据 。 


Xcode 任务 集 


当 看 到 这 里 的 时 候 ， 你 已 经 学 习 了 深入 了 解 Xcode 工 具 集 内 部 细节 的 基础 知识 。 第 四 部 分 将 会 学 习 一 些 比 第 二 部 分 和 第 三 部 


分 更 需要 认真 对 待 的 内 容 。 


第 24 章 ，Xcode 中 的 文档 


向 系统 中 添加 你 自己 的 文档 。 





该 章 将 会 介绍 Xcode 如 何 为 你 提供 API 的 即时 帮助 ， 并 浏览 Cocoa 开 发 中 概念 的 细节 ， 揭 示 如 何 


第 25 章 ，Xcode 构 建 系统 





该 章 将 会 介绍 Xcode 将 源 文 件 转 化 为 可 执行 文件 的 过 程 背 后 所 使 用 的 工具 和 规则 。 





第 26 章 ，Instruments 使 用 Apple 的 timeline profiler， 你 可 以 超越 基本 的 性 能 和 内 存 诊 断 ， 从 整体 上 观察 程序 如 何 使 用 它 的 





第 27 草 ， 调 试 


地 掌控 自己 的 代码 。 


如 何 使 用 断 点 和 条 件 来 减少 内 部 代码 诊断 。 你 也 可 以 找到 一 个 关于 11db 调 试 器 命令 集 的 教程 ， 以 更 进一步 





第 28 章 ， 零 散 的 知识 综合 介绍 一 些 开 发 工具 中 会 遇 到 的 小 技巧 、 陷 阱 以 及 特性 。 


附录 


第 五 部 分 的 附录 包含 帮助 你 掌握 构建 系统 的 参考 信息 ， 还 有 寻找 帮助 和 支持 的 途径 。 


附录 A， 一 些 构建 变量 





Xcode 构建 系统 中 最 重要 的 配置 和 环境 变量 。 


HRB, W% 





介绍 能 在 开发 过 程 中 助 你 一 臂 之 力 的 书 、 工 具 和 网 络 资源 。 


天 于 版 本 


本 书 基 于 OS X 10.10. iOS 8.2 和 Xcode 6.2 编 写 而 成 。 


天 于 代码 


本 书 中 有 很 多 可 执行 的 示例 代码 ，Xcode 6 是 一 个 创建 并 运行 代码 的 系统 。 本 书 旨 在 教授 工作 流程 。 代 码 本 身 是 学 习 工 作 流 
程 时 附带 的 内 容 。 尤 其 要 注意 : 本 书 中 绝 大 部 分 代码 在 一 开始 都 无 法 正常 运行 。 本 书 是 一 本 介绍 开发 流程 的 书 ， 大 部 分 内 容 都 涉 
及 寻找 和 解决 bug。 如 果 不 学 着 处 理 所 碰 到 的 问题 ， 你 就 无 法 学 习 整 个 工作 流程 。 


所 以 本 书 给 出 的 都 是 一 些 有 问题 的 代码 。 可 能 你 会 发 现 这 些 代 码 难 以 阅读 ， 并 且 如 果 你 尝试 运行 这 些 代 码 ， 也 会 感觉 很 痛 


苦 。 相 信 我 ， 这 人 么 做 肯定 是 有 原因 的 。 


本 书 的 示例 代码 都 可 以 在 华章 公司 网 站 下 载 : www.hzbook.com。 如 果 你 在 阅读 的 过 程 中 使 用 示例 代码 ， 并 用 Git (或 者 
Subversion) 作为 工作 中 的 代码 版 本 管理 工具 ， 那 么 需要 将 更 改 复 制 到 自己 的 工作 目录 中 。 如 果 直 接 用 示例 文件 夹 替换 自己 的 文 
件 夹 ， 将 会 导致 自己 的 版 本 信息 丢失 。 


本 书 中 命令 行 的 部 分 内 容 可 能 会 比 一 页 书 还 要 宽 ， 所 以 我 遵循 在 行 末 尾 添加 \ 来 换行 的 约定 。 大 段 的 输出 内 容 将 会 简单 地 将 
出 行 包 含 很 长 的 文件 路 径 的 时 候 ， 我 会 用 省 略 号 Cee ) 来 替代 不 重要 的 部 分 ， 仅 
仅 留 下 重要 的 部 分 。 


Macintosh 在 其 最 初 的 20 年 中 就 使 用 单 按键 的 鼠标 (不 要 笑 ， 很 多 购买 者 都 不 知道 这 是 什么 样 的 鼠标 ， 会 在 一 个 古老 的 Mac 鼠 
标 上 按 错 误 的 按键 ) 。 现 在 它 有 4 种 方法 可 以 实现 鼠标 点 击 的 效果 : 在 一 个 实际 鼠标 上 点 击 右键 (或 者 点 击 虚 拟 鼠 标的 某 个 代表 
右键 点 击 的 角落 ) ; 按 住 Ctdl 键 同时 进行 普通 的 点 击 操 作 ; 用 两 个 手指 敲 击 多 点 触摸 屏 (即便 在 台式 机 上 这 个 操作 也 越 来 越 党 
见 ) ; 或 者 点 击 多 点 触摸 屏 指 定 角落 。 在 “系统 偏好 ” (System Preferences) 中 有 更 多 可 以 设置 的 选项 。 除 非 差 别 特 别 大 ， 否 则 
我 会 统称 这 些 操作 为 “ 右 击 ” (right-click) ， 由 你 自己 选择 到 底 使 用 哪个 操作 。 


人 致谢 


当 你 拿 到 这 本 书 的 时 候 ， 其 实 文 字 编 撰 只 占 出 版 过 程 的 一 部 分 内 容 。 我 要 感谢 那些 在 背后 默默 奉献 的 人 ， 没 有 他 们 本 书 就 无 


法 与 读者 见面 。 大 部 分 人 名 都 会 出 现在 正式 的 制作 人 员 列 表 中 ， 但 是 他 们 应 当 收 获 比 正式 感谢 更 多 的 褒奖 


Trina MacDonald 面 对 有 诸多 更 改 的 Xcode， 克 服 了 巨大 的 困难 ， 完 成 了 本 书 的 再 版 。 这 并 不 是 一 件 保 证 能 够 完成 的 工作 ， 但 
是 她 做 到 了 。 谢 谢 她 。 


Lori Hughes 和 凭借 丰富 的 幽默 细胞 给 我 们 开 了 个 好 头 ， 为 我 们 安排 了 严谨 的 日 程 表 。Julie Nahil， 我 们 的 产品 经 理 ， 很 旱 就 开始 
运作 ， 让 工作 能 够 按照 日 程 表 的 计划 进行 ， 而 且 在 本 书 从 手稿 到 成 书 的 过 程 中 还 做 了 很 多 份 外 之 事 。 


Olivia Basepio 确 保 了 所 有 的 合同 、 公 文 往 来 (包括 提升 薪水 ) 的 正常 沟通 。 她 还 组 织 评审 人 员 在 本 书 还 处 于 未 装订 阶段 就 开 
始 了 审阅 工作 。 


审阅 人 Chris Zahn, Gene Backlin 和 Josh Day 悉 心 审阅 了 本 书 ， 让 整 本 书 的 质量 与 最 开始 相 比 提高 了 不 少 。 当 然 可 能 还 有 一 些 
错误 ， 有 一 些 是 无 意 造成 的 ， 有 一 些 是 我 自身 水 平 导 致 的 ， 无 论 怎样 ， 都 是 我 的 问题 。 


文字 编辑 Stephanie Geels 完 成 了 文字 、 语 法 错误 的 相关 检查 ， 并 为 特定 的 文字 找到 了 对 应 的 字体 ， 其 中 的 过 程 很 有 意思 。 


职工 作对 作者 来 说 不 是 件 好 事 (除了 能 钙 全 职工 资 以 外 ) o Alan Takaoka， 芝 加 可 大 学 IT Services P Web Service 部 门 的 负责 
人 ， 在 我 写作 期 间 ， 让 我 每 周 休息 三 四 天 。 我 保证 在 撰写 本 书 的 过 程 中 参加 所 有 的 会 议 并 在 截止 日 期 之 前 完成 所 有 的 工作 。 不 过 
很 少 有 工作 会 安排 在 周一 或 者 周 五 。Cotnelia Bailey 帮 我 管理 了 绝 大 多 数 项 目 ， 并 合理 地 重新 安排 进度 


Bess 和 Kate 带 给 我 的 麻烦 比 我 撰写 本 书 时 遇 到 的 怀疑 和 沁 吕 更 多 ,但 却 让 我 对 本 书 将 会 写 得 更 好 充满 了 信心 ， 这 也 许 就 是 这 
两 个 小 家 伙 的 心意 。 


` 第 1 章 ”获取 Xcode 

` 第 2 和 章 AIRXcode 

` 第 3 草 ”简单 的 工作 流程 和 被 动 调试 
HAR ”主动 调试 

“ 第 5 章 ”编译 

` 第 6 章 添加 库 target 


-475 ”版 本 控制 


S15; ”获取 Xcode 


如 果 要 使 用 Xcode， 首 先 需 要 安 洲 。 之 前 开发 工具 都 打包 在 OS X 系 统 中 ， 但 是 现在 ， 你 必须 自己 安 闪 ,然后 将 Xcode 拖 


到 /Applications 文 件 夹 中 ， 然 后 启动 。 


1.1 开始 之 于 


在 继续 往 下 进行 之 前 ， 首 先 要 确定 你 能 使 用 Xcode 6。 有 以 下 两 点 需要 考虑 。 
为 之 前 的 操作 系统 做 开发 


当 Apple 友 布 Xcode 的 新 版 本 时 ， 还 会 上 友 布 最 新 版 本 的 iDOs(8) 开 友 包 (SDK) ， 并 指明 Xcode 运行 需要 的 OS X 系 统 版 本 
(Mavericks 10.9 和 Yosemite 10.10) 。 理 论 上 ， 这 并 不 算 什么 限制 : 为 了 能 为 早 前 的 操作 系统 版 本 开 友 ，3SDK 能 很 好 地 兼容 
之 前 的 版 本 。 


不 过 ， 有 一 些 API 没 有 升级 (就 像 之 前 ， 一 个 不 兼容 的 libcrypto 版 本 存在 于 OS X 10.6 版 本 中 ， 直 到 一 年 后 升级 了 这 个 库 才 
消除 了 警告 ) 。 这 种 情况 也 同样 出 现在 PowerPC 的 开 友 中 。 如 果 你 需要 这 么 做 ， 请 找 一 人 台 能 够 运行 O3 X 10.6 版 本 和 Xcode 
3.2.6 版 本 的 机 器 。 我 将 会 在 25.7 节 辐 你 解释 ， 如 何 使 用 xcode-select 这 个 工具 在 多 个 版 本 的 Xcode 中 切换 。 


St 有 些 人 曾经 问 过 是 否 能 将 之 前 版 本 的 Xcode 中 的 SDK 拿 出 来 放 到 Xcode 6 中 使 用 。 实 际 上 这 样 无 法 正常 运行 : 因为 
旧版 本 的 SDK 依 赖 的 编译 器 和 运行 时 库 在 Xcode 6 中 并 不 可 用 ， 同 时 Xcode 6 会 假设 它 所 包含 的 SDK 会 支持 它 本 身 带 有 的 工具 。 引 
用 一 位 Apple Developer Tools 工 程 师 的 一 句 话 : “Xcode 没有 对 它 不 支持 的 配置 做 任何 测试 。- 
配置 要 求 
Apple 对 Xcode 的 运行 需求 很 谨 愤 ， 不 过 这 也 很 好 理解 ， 因 为 它 依赖 于 你 的 使 用 和 偏好 。 
- Xcode 6 的 运行 需要 OS X Marvericks (10.9) X, Yosemite (10.10) à 
` 下 载 的 包 大 小 大 概 有 2 GB. 


- 安装 Xcode 需 要 的 硬盘 空间 大 小 取决 于 你 下 载 了 多 少 帮 助 文档 和 支持 工具 。 全 新 安装 大 概 需要 6.5 GB 的 空间 ; 但 是 若 增 加 
了 其 他 一 些 选 项 ， 那 么 占用 9GB 的 空间 也 很 常见 。 


` Xcode 6 的 运行 需要 2 GB 的 内 存 ， 不 过 如 果 你 真 的 在 2 GB 内 存 的 机 器 上 运行 Xcode， 那 么 你 除了 能 看 看 Xcode 的 样子 外 ， 用 
它 也 做 不 了 什么 工作 。 对 于 本 书 中 的 例子 而 言 ，4 GB 的 内 存 足 够 用 ,但 是 对 于 中 型 项 目 来 说 ， 我 的 经 验 是 基础 需要 3 GB， 然 后 
处 理 器 每 增加 1 核 ， 就 再 增加 750 MB 的 内 存 。 请 尽 可 能 地 增加 RAM 的 容量 ， 到 现在 为 止 ， 我 还 没有 听 说 过 因为 内 存 的 增加 而 造成 
收益 递减 的 情况 。 


- Xcode 是 一 款 64 位 的 Intel 应 用 程序 ， 所 以 机 器 的 最 低 要 求 是 64 位 、 双 核 、CPU 1.2 GHz。 当 然 配 置 越 高 越 好 。 


` 屏幕 越 大 (尤其 是 越 宽 ) ， 显 示 效 果 越 好 。 撰 写本 书 的 时 候 我 使 用 的 是 1440 水 平分 辨 率 的 MacBook Ait。 使 用 我 之 后 会 介 
绍 的 显示 管理 技巧 ， 大 多 数 时 间 你 都 会 感到 很 舒服 。 而 我 的 15 英 寸 的 Retina 屏 幕 的 MacBook Pto 可 以 显示 更 多 的 内 容 ， 我 很 喜欢 。 


本 书 的 最 低 要 求 是 一 台 Mac mini， 在 我 撰写 本 书 的 时 候 ， 它 的 售 价 为 9599 (在 美国 ) , BARTA, BR. Che 
从 2010 年 开始 出 贷 量 最 大 的 Mac 产 品 。 


注意 写作 本 书 的 时 候 ，Xcode 已 经 升级 到 6.2， 运 行 在 ODS X 10.10 Yosemite 上， 可 以 使 用 Swift 1.2。 如 果 你 正在 使 用 


Marvetics 这 个 OS X 版 本 ， 那 么 需要 注意 的 是 ， 你 在 自己 的 机 器 上 看 到 的 Xcode 窗 口 可 能 会 与 我 在 书 中 展示 的 Xcode 窗 口 的 显示 有 


所 不 同 ， 而 且 ， 书 中 有 些 练 习 (特别 是 Mac stotyboatd 相 关 的 练习 ) 脱离 了 Yosemite 无 法 运行 。 


1.2 %&Xcode 

大 多 数 时 候 ， 获 取 Xcode 6 非常 容易 : 在 Mac App Store (MAS) 中 找到 它 ， 输 入 Apple ID 和 密码 ， 残 可 以 开始 下 载 。 它 
是 免费 的 。 还 有 一 种 下 载 方式 会 在 1.5 节 介绍 ， 同 时 也 会 介绍 为 什么 需要 这 种 下 载 方 法 。 

一 旦 下 载 完 成 ，Xcode 将 会 放 在 /Applications 文 件 夹 中 。 


注意 想 要 查看 下 载 的 所 有 内 容 ? 右 击 /Applications 中 的 Xcode 图 标 ， 然 后 选择 Show Package Contents， 就 能 看 到 表示 
Xcode 的 伪 文 件 后 面 的 所 有 目录 和 文件 。 随 意 查看 你 感 兴趣 的 内 容 ， 但 是 注意 不 要 做 任何 更 改 。 


没有 下 一 步 ， 不 需要 安 涂 选项 ， 疫 有 安 六 器 。 人 在 早期 的 版 本 中 ， 开 友 工 具 都 放 在 局 动 卷 的 /Developer 目 录 中 (或 者 存放 在 
你 在 安 委 器 中 选择 的 目录 中 ) 。 这 种 情况 已 经 不 复 存 在 ,现在 iOS 和 Mac 开 友 需 要 的 所 有 工具 都 包含 在 Xcode 和 目 身 中 。 


大 部 分 文档 都 没有 安装 。 首 次 查看 文档 的 时 候 Xcode 会 自动 下 载 。 将 文档 与 Xcode 的 下 载 捆绑 在 一 起 没有 实用 价值 ， 因 为 文 
档 占 据 的 空间 很 大 ， 文 档 的 更 新 速度 要 比 开 发 工具 的 更 新 速度 快 很 多 ， 而 且 你 也 不 会 想 下 载 全 部 文档 。 偏 好 窗口 中 的 
Downloads 面 板 可 用 来 管理 下 载 进度 。 


MAs 分 友 还 有 一 个 优点 融 是 ， 一 旦 App Store 应 用 程序 知道 本 机 安装 了 Xcode， 那 么 当 有 更 新 的 时 候 ， 它 束 会 提示 你 。 当 你 
允许 更 新 操作 ，App Store 束 会 仅 友 送 它 更 改 的 那些 组 件 ， 这 将 会 极 大 地 减少 下 载 时 间 。 下 载 小 于 100MB 的 组 件 基本 上 使 人 无 
法 察 完 。 
命令 行 工 具 


Xcode 安装 之 后 ，Marvericks 和 和 Yosemite 放置 可 执行 文件 的 /usr/bin 目 录 中 会 包含 常见 的 开发 工具 make、gcc、clang 
等 。 开 源 项 目 在 安装 之 前 先 要 构建 ， 构 建 的 时 候 会 在 这 个 目录 下 寻找 所 需 的 工具 。 但 是 它们 对 应 的 并 不 是 这 些 名 称 所 指向 的 真正 
程序 ， 它 们 是 一 些 “ 跳 板 ” (trampoline) ， 当 你 运行 它们 的 时 候 ， 会 切换 到 系统 中 真正 的 程序 。 


- 如 果 存 在 Xcode， 那 么 会 转向 容 入 在 Xcode 应 用 程序 包 中 的 工具 。 
如 果 存 在 /Library/Developet 这 个 目录 ， 那 么 会 转向 这 个 目录 下 的 工具 。 这 个 目录 是 可 选 的 命令 行 工具 包 的 安装 目录 。 


如 果 以 上 两 个 地 方 都 没有 有， 那么 “跳板 ”程序 将 会 提供 下 载 和 安装 命令 行 工具 包 。 你 也 可 以 执行 sudo xcode-select--install 来 


达到 相同 的 效果 。 
无 论 哪 种 情 ; 咒 ，/usr/bin 中 的 可 执行 程序 总 是 “跳板 ”。 


所 以 如 果 你 现在 已 经 安 容 了 Xcode 6， 那 束 不 需要 表单 独 安 滚 开 友 工 具 包 。 系 统 将 认为 它们 已 经 存在 了 一 一 Xcode 和 命令 行 
构建 将 会 使 用 相同 的 工具 ， 这 将 会 减轻 大 部 分 开 友 者 的 很 多 负担 。 


如 果 你 不 需要 Xcode 6， 那 融 不 要 安 疼 它 。 运 行 其 中 的 一 个 工具 ， 或 者 进入 http://developer.apple.com/downloads 下 载 
一 个 安装 器 。 请 确保 下 载 的 安装 器 的 版 本 与 你 的 OS X 版 本 相 匹 配 。 


1.3” 移 除 Xcode 


也 许 是 因为 生活 友 生 了 变化 ， 或 者 蜜月 结束 ; 也 有 可 能 是 因为 你 已 经 尝试 过 了 Xcode， 现 在 不 想 再 用 了 ; 或 者 你 想 编辑 一 部 
戏剧 ， 希 望 腾 出 一 些 空间 ; 还 有 可 能 是 因为 你 要 把 Mac 送 给 上 艺术 学 校 的 女儿 。 忆 之 ， 有 各 种 各 样 的 原因 使 得 你 不 骨 需 要 
Xcode， 那 么 怎样 才能 删除 它 ? 


早期 的 Xcode 删除 过 程 十 分 复杂 ， 它 涉及 凶 载 脚本 以 及 目录 的 删除 。 现 在 ， 基 本 上 你 仅 需 将 Xcode 拖 入 垃圾 箱 即 可 。 


为 什么 早期 的 Xcode 删除 过 程 这 么 复杂 ? 这 是 因为 之 前 安 法 了 Xcode 之 后 ， 包 载 的 时 候 不 得 不 删除 很 多 混入 系统 内 部 的 工 
具 、 库 、 头 文件 、 框 架 等 。 季 载 脚 本 会 毅 历 所 有 的 相关 目录 ， 逐 一 删除 相关 文件 。 


但 是 记 住 我 之 前 提 到 的 命令 行 工具 : 这 些 工具 和 其 他 文件 都 在 Xcode 之 中 。 所 有 不 在 这 些 文件 学 围 内 的 文件 都 是 这 些 文件 的 
跳板 。 删 除 Xcode 之 后 ， 残 会 删除 与 这 些 工具 相关 的 所 有 文件 。 


除非 你 安装 了 单独 的 命令 行 开 发 工具 包 (Command Line Developer Tools package) 。 在 /Library/Developer 这 个 文件 
夹 下 会 找到 这 些 文件 以 及 部 分 大 型 文档 库 ， 删 除 那 个 目录 ， 对 ~/Library/Developer/ 目 录 也 执行 相同 的 操作 。 


1.4 Apple 开 发 者 计划 
任何 人 都 可 以 用 Xcode 6 免费 进行 OS X 和 iOS 软 件 开 友 。 如 果 你 想 自 己 友 布 Mac 软 件 ， 那 么 现在 准备 工作 已 经 完成 : 之 后 的 
工作 就 是 构建 应 用 程序 ， 再 将 它们 放 到 网 上 ， 剩 下 的 束 祈 求 老 天 保佑 吧 。 


然而 ， 如 果 你 想 将 软件 提交 到 Mac 或 者 iOS 的 应 用 商店 里 ; 或 者 向 使 用 Gatekeeper 的 用 户 保证 你 的 Mac 应 用 是 安全 的 ; 或 
者 想 在 设备 上 测试 iOS 应 用 ， 那 还 有 很 多 工作 要 做 。 你 需要 为 加 入 Mac 或 者 iOS 开 友 者 计划 (Apple Developer Program) 付 
费 。 (如 果 需 要 ， 这 两 个 开发 者 计划 都 可 以 加 入 。) 


加 入 Apple 开 发 者 计划 的 政策 和 方法 可 能 会 变更 ， 所 以 我 只 能 给 你 介绍 下 大 概 情况 。 首 先 打 开 这 个 链 
有 过: http://developer.apple.com， 加 入 iDOS 和 Mac 开 友 者 计划 的 链接 在 一 个 显著 位 置 。 这 个 计划 能 够 让 你 : 


- 使 用 预 发 行 版 软件 的 权限 ， 包 括 操作 系统 和 开发 者 工具 。 
- 访问 开发 者 论坛 (http://devforums.apple.com/) 中 未 对 外 开放 部 分 的 权限 。 


` 两 次 获得 开发 者 技术 支持 的 机 会 (DTS ，Developet Technical Support) ，Apple 的 工程 师 会 对 你 的 开发 策略 提出 建议 ， 并 帮 
助 你 进行 问题 诊断 。 这 是 获得 Apple 支 持 的 唯一 官方 、 受 保护 的 途径 。 如 果 时 间 充 裕 ， 有 问题 一 定 要 先 去 开发 者 论坛 或 者 邮件 列 
表 (在 附录 B 中 可 以 找到 这 些 链接 ) 查看 有 没有 解决 方法 。 但 是 如 果 没 有 找到 想 要 的 答案 ， 那 么 DTS 是 最 好 的 选择 。 


- 拥有 向 Mac 或 者 iOS 应 用 商店 提交 用 于 售卖 的 应 用 程序 的 权利 。 
- 对 于 iOS 开 发 来 说 ， 还 能 拥有 将 程序 部 团 到 设备 上 调试 的 权利 (详情 见 第 18 章 ) 。 
- 对 于 OS XH, Developer ID 是 允许 你 将 应 用 程序 安装 到 使 用 Gatekeeper 的 用 户 设备 上 的 凭证 。 


在 两 个 开 友 者 计划 之 间 做 出 选择 ， 然 后 你 会 进入 市 有 “加 入 ” (Enroll Now) 字样 按钮 的 页 面 ， 页 面 上 还 标 有 加 入 开发 者 
计划 一 年 所 需 的 费用 ( 当 我 撰写 本 书 的 时 候 ， 美 国 需 要 $99) 。 


下 一 步 融 是 建立 “已 注册 的 Apple 开 有 友 者 ” 喘 份 。 已 注册 开 友 者 比 注 册 Apple 免 费 账号 的 用 户 多 拥有 一 些 权利 (有 一 小 部 分 
俊 源 需要 你 同 晶 一 些 条 款 ， 比 如 说 访问 开 友 者 论坛 中 已 友 布 的 产品 板块 ) 。 如 果 你 已 经 注册 过 了 ， 可 以 跳 过 注册 流程 ， 如 果 没 
有 ， 出 示 你 的 Apple ID (比如 可 能 在 iTunes 中 使 用 的 账号 ) 或 者 新 注册 一 个 ， 填 写 市 场 科 人员 基本 信息 ， 最 后 要 同意 Apple 开 上 友 
者 计划 的 条 丈 。 他 们 会 给 你 友 送 一 封 用 于 确认 合同 信息 的 邮件 。 


完成 上 面 的 步 又 之 后 ， 接 下 来 束 是 选择 开发 计划 。 选 择 你 感 兴趣 并 且 买 得 起 的 那 项 开 友 计划 。iOS 和 和 Mac 会 分 开 收费 ， 也 没 
有 折扣 。 还 有 一 个 免费 的 Safari 开 友 计 划 ， 人 允许 你 针对 桌面 的 Safari 网 页 浏览 器 进行 开发 和 扩展 。 


接 下 来 ， 需 要 同意 一 些 开 友 者 计划 指定 的 许可 。 完 成 乙 后 ， 你 融 成 为 Apple 开 上 友 者 计划 的 一 员 了 。 


1.5 ”下载 Xcode 


在 应 用 商店 里 下 载 Xcode 很 万 便 ， 但 却 不 适用 于 每 个 人 。 新 版 本 的 Xcode 一 一 甚至 是 友 布 修正 的 小 版 本 一 一 有 可 能 抛弃 一 
些 你 可 能 会 用 到 的 功能 。Xcode 支 持 在 计算 机 中 存在 多 个 版 本 ,但 是 应 用 商店 不 支持 。 当 你 同 总 来 自 应 用 商店 的 更 新 ， 它 会 找到 
老 版 本 并 删 掉 ， 无 论 它们 在 什么 位 置 。 你 必须 要 上 自己 来 接管 整个 流程 。 


wits 见 第 25 章 ，xcode-select 和 xcrun 命 令 行 工 具 支 持 使 用 多 个 版 本 的 Xcode。 如 果 你 是 开发 者 计划 中 的 一 员 (即便 仅 是 
免费 计划 的 一 员 ) ， 可 以 访问 http://developer.apple.com/downloads。 使 用 匀 选 复 选 框 缩 减 列 出 的 开发 者 工具 数量 。 你 会 发 现 每 个 
Xcode 工具 集 的 最 低 版 本 都 是 1.0 (针对 OS 义 10.3 版 本 的 584M 镜 像 ) 。 当 前 新 发 布 的 Xcode 在 最 靠 上 的 人 位置， 下载 它 。 


如 果 你 想 要 获得 预 友 布 的 版 本 ， 需 要 进入 IOS 或 者 OS X 开 上 友 痢 中 心 ， 用 已 付费 的 开 友 痢 账号 登录 ， 选 择 预 友 布 ， 然 后 融会 获 
得 一 个 Mac 应 用 商店 兄 换代 码 。 用 这 个 兄 换代 码 就 能 获得 最 新 的 Xcode 预 友 布 版 本 ，Mac 应 用 商店 也 会 随 之 局 动 更 新 。 


最 后 你 会 获得 一 个 压缩 的 桌面 镜像 文件 (.dmg) 。 双 击 这 个 文件 ， 得 到 Xcode 应 用 程序 。 将 它 拖 入 /Applications 或 者 其 他 
你 喜欢 的 地 方 。 如 果 你 想 要 保留 之 前 的 版 本 ， 请 先 将 这 个 文件 重 命 名 。 


与 从 MAqS 中 更 新 Xcode 相 比 ， 自 己 下 载 并 更 新 有 两 点 不 方便 的 地 方 : 一 是 你 需要 自己 跟踪 Xcode 的 更 新 ; 二 是 需要 重新 下 
载 全 部 工具 集 ， 无 法 使 用 增 量 更 新 。 


Oss Apple 的 官方 立场 是 Yosemite 系 统 只 支持 Xcode 6。 之 前 ，Apple 对 于 “支持 ”这 个 词 的 意义 很 保守 ， 它 用 于 描述 新 
版 本 的 操作 系统 可 以 使 用 老 版 本 的 开发 工具 。 我 的 解释 是 : 开发 工具 (Developer Tools) 在 主 版 本 的 Xcode 中 已 经 做 得 很 好 了 ， 
无 需 再 白费 力气 测试 并 更 新 过 时 的 版 本 。 老 版 本 也 许 能 够 工作 ， 也 许 不 能 ， 但 Apple 已 经 不 打算 再 提供 支持 。 


1.6 ”额外 需要 下 载 的 内 容 


早期 版 本 的 Xcode 最 大 有 3 GB, Xcode 4.3 镜 像 仅 有 一 半 大 ，1.8 GB, 


Apple 控 制 Xcode 下 载 包 大 小 的 方法 之 一 是 仅 提 供 OS X 和 iOS 文 档 的 主要 部 分 。 当 你 第 一 次 运行 Xcode 的 时 候 ， 它 会 触发 下 
载 元 整 文档 的 操作 。 这 让 那些 想 要 在 安装 完 Xcode 之 后 束 立 刻 能 拥有 它 完 整 功能 的 人 十 分 烦躁 ， 但 这 真 的 没有 办 法 : 因为 并 不 是 
每 个 人 都 需要 全 部 文档 。 而 且 ，Apple 更 新 文档 的 频率 要 远 远 大 于 更 新 Xcode 的 频率 ， 所 以 即使 下 载 包 包 合 了 全 部 文档 ， 当 使 用 
的 时 候 还 是 要 获取 当前 最 新 的 文档 。 


另 一 个 减 小 下 载 包 大 小 的 近 巧 融 是 知道 并 不 是 每 个 人 都 需要 所 有 的 开 友 工具 。Apple 将 7 个 工具 集 从 Xcode 下 载 包 中 分 离 出 
来 ， 放 入 可 下 载 包 中 。 这 样 做 不 仅仅 可 以 让 这 些 文件 从 主 下 载 包 中 分 离 出 来 ， 还 允许 Apple 让 这 些 工 具 从 Xcode 的 上 友 布 周期 中 分 


下 面 是 我 撰写 本 书 时 可 用 的 包 : 
审核 和 测试 Mac 应 用 程序 访问 性 支持 的 工具 。 





- Accessibility 
Repeat After Me 〈 语 音 合 成 转换 ) ， 以 及 为 Mac Dictionary A) Fz 


检查 Core Audio 单 元 的 应 用 程序 ， 包 含 头 文件 和 示例 代码 。 











- Audio 
- Auxiliary Help Indexer (创建 Mac 应 用 程序 帮助 手册 ) 
序 创建 新 字典 的 工具 。 
- Command-line tools 包含 一 些 在 Terminal 应 用 程序 中 执行 的 命令 ， 用 于 一 些 传统 类 型 的 开发 。 可 以 在 不 安装 Xcode 的 情况 
器 ， 开 发 出 的 程序 可 以 作为 OS X Dashboard 的 小 工具 


下 使 用 这 个 工具 。 
Apple 针 对 HTML5/CSS/JavaScript 开 发 的 可 视 化 编辑 器 ， 


- Dashcode 
(widget) ， 也 能 用 于 开发 类 iOS 应 用 的 Web 应 用 。 
与 Network Link Conditionet 一 样 ， 允 许 你 降低 网 络 性 能 和 可 靠 性 ， 由 此 模拟 iDOS 模 拟 





Be 
aes 


P 


- Hardware IO 一 一 USB 和 蓝牙 探测 


器 中 的 移动 连接 。 
OpenGL 开 发 工具 ， 用 于 连接 图 像 和 视频 过 滤器 的 Quartz Composer builder. 





- Graphics 
要 使 用 这 些 补充 工具 中 的 一 个 ， 请 打开 Xcode， 选 择 Xcode 一 Open Developer Tool—More Developer 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/…， 默 认 浏览 器 就 会 打开 开发 者 下 载 网 站 ， 且 搜索 


如 果 你 想 
Toolshttp://www.hzcourse.com/resource/readBook? 


框 中 已 填 入 关键 字 for Xcode-， 这 样 束 能 为 访问 者 显示 出 可 用 的 工具 ，。 
当 你 找到 想 要 下 载 的 工具 ， 单 击 提示 三 角 丈 会 显示 出 包 的 描述 内 容 以 及 一 个 下 载 链 接 。 然 后 需要 阅读 并 同意 Apple 开 发 者 工 


具 的 通用 许可 证 。 同 意 之 后 ， 下 载 束 开始 了 。 
下 载 完 成 后 得 到 的 是 一 个 包含 应 用 程序 和 安 沪 器 的 .dmg 磁 盘 镜 像 。 可 以 将 应 用 程序 把 入 /Applications 或 者 其 他 任何 你 觉得 


方便 的 地 方 ， 但 是 这 样 做 它们 不 会 出 现在 Xcode 茉 单 中 。 
除了 这 些 特殊 的 工具 集 ， 还 有 一 些 组 件 如 设备 调试 软件 (device-debugging software) 以 及 兼容 老 ijDs 版 本 的 模拟 器 。 如 
TA. 


果 需 要 ， 打 开 偏 好 窗口 ， 选 择 Downloads 面 板 ， 在 Components 部 分 来 下 载 这 


1.7 ”小结 
在 让 Xcode 对 于 每 个 人 都 易于 获得 ， 与 提供 安装 哪些 工具 以 及 安装 多 少 工具 的 选择 之 间 保持 平衡 。 从 Mac 
要 更 特殊 的 工具 一 一 比如 老 版 本 的 Xcode 或 


进行 IOS 和 OS X 开 友 需 要 的 全 部 工具 。 如 果 人 


Fatk7e 、 


Apple 公 司 尽 
会 让 你 获得 


量 
App Store 中 免费 安装 ， 
者 目 定义 工具 集 一 一 那么 在 开发 者 下 载 站 能 找到 这 些 工具 。 


第 2 草 ” 初 识 Xcode 


现在 你 已 经 安 交 了 Xcode， 让 我 们 局 动 Xcode 看 看 它 的 样子 。 


2.1 局 动 Xcode 


正如 其 他 程序 一 样 ， 你 会 在 /Application 文 件 夹 中 找到 Xcode。 因 为 你 将 会 频繁 地 使 用 Xcode， 所 以 你 可 能 想 要 让 它 一 直 出 
现在 主屏 幕 下 方 的 Dock 栏 中 。 拖 动 Xcode 的 图 标 到 Dock 栏 中 ， 小 心地 将 Xcode 的 图 标 拖 到 其 他 图 标 之 | 间 ， 而 不 是 其 他 图 标 之 
上 。 


单 击 Xcode 图 标 ， 它 会 上 下 跳动 以 示 正 在 载 入 。Xcode 的 图 标 将 会 上 下 跳动 很 长 时 间 ， 然 后 停止 跳动 ， 之 后 什么 也 没有 出 
现 。 


这 是 因为 当 OS X 上 面 的 应 用 程序 第 一 次 运行 的 时 候 ， 操 作 系统 会 检查 应 用 程序 包 ， 验 证 它 的 加 密 签名 。 通 常 一 个 应 用 程序 
有 大 概 2000 个 文件 ， 检 查 文 件 会 造成 程序 局 动 延迟 ， 如 果 你 多 加 留意 天 会 友 现 。 


Xcode 6 有 大 概 188000 个 文件 ，OS X 必 须 验 证 所 有 的 文件 ， 这 将 花费 大 量 的 时 间 。Apple 现 在 会 用 进度 条 来 显示 验证 的 进 
， 这 样 你 束 知 道 大 概要 等 多 久 才能 进入 应 用 程序 。 等 文件 验证 完毕 ， 束 可 以 进入 Xcode 开始 工作 。 


K 


当 你 第 一 次 运行 任何 一 束 Apple 开 友 者 工具 一 一 即使 是 命令 行 工具 一 一 你 也 会 被 要 求 阅 读 并 接受 天 于 工具 和 3SDK 的 许可 协 
议 。 这 个 过 程 与 其 他 任何 单 击 同意 残 可 以 使 用 的 协议 一 致 。 


接 下 来 ，Xcode 会 请 求 安装 需要 的 “附加 组 件 ” 的 许可 。 人 允许 这 个 操作 ， 并 出 示 管 理 者 凭证 信息 (credential) 。 这 些 组 件 
与 Tunes 框 架 会 产生 重 考 ， 所 以 可 能 会 要 求 天 闭 iTunes。 


一 旦 进度 条 窗口 消失 ， 束 会 看 到 欢迎 窗口 Welcome to Xcode ( 见 图 2.1) 。 


Welcome to Xcode 


-a Get started with a playground 
4") Explore new ideas quickly and eas! y 


— ale a hew code progs 可 | 
tart Building a fnew IPhone, iPad or Mac application 


ETA Check out an existing project 
Start working on something from an SCM repository 


Open another project... 





A2.1 当 你 局 动 Xcode， 它 会 显示 一 个 带 有 创建 新 项 目 (Get started with a playground) 、 重 新 打开 最 近 项 目 (Creat anew Xcode 


project) ， 或 者 从 源 代 码 管 理 仓 库 中 拉 去 项 目 (Check out an existing project) 这 几 个 选项 的 Welcome 窗 口 


如 果 这 是 你 第 一 次 运行 Xcode， 右 侧 的 表单 是 空 的 (No Recent Projects) ; 随 着 项 目的 增加 ， 这 个 表 中 会 包含 对 这 些 项 目 
的 索引 ， 这 样 你 惑 能 获得 一 种 快速 回 到 之 前 工作 环境 中 的 方法 。 当 这 个 列表 中 有 了 一 些 项 目 以 后 ， 束 可 以 选择 一 个 ， 但 是 Xcode 
并 没有 显示 任何 可 以 打开 它 的 方式 。 打 开 这 些 项 目的 小 技巧 就 是 双击 想 要 打开 的 项 目 ， 或 者 按 回 车 (return) 键 。 


在 欢迎 窗口 中 ， 你 有 4 个 选项 可 供 选 择 : 


- Get stattd with aplayground。playgtound 是 一 个 能 接受 Swift 编程 代码 的 文件 ， 并 能 交互 性 地 翻译 代码 





它 并 不 仅仅 是 一 个 
输入 输出 (type-and-print) 的 控制 台 窗口 。playgtound 能 实时 显示 代码 的 所 有 结果 : 代码 的 结果 能 立刻 显示 出 来 ， 同 时 你 做 的 任何 
更 改 都 将 会 反映 在 整个 文件 中 。 


- Create anew Xcode ptoject。 这 个 选项 很 有 用 ， 它 可 以 告诉 你 如 何 创 建 一 个 新 项 目 。 可 能 你 马上 就 想 创 建 一 个 新 项 目 ， 但 是 
稍 等 一 下 。 你 也 可 以 选择 File 一 New 一 New Project (他 oN) 来 创建 新 项 目 。 


- Check out an existing btoject。Xcode 认 为 ， 即 便 对 于 小 项 目 来 讲 ， 源 代码 管理 也 非常 重要 。 可 能 并 不 是 从 你 自己 的 代码 开始 
开发 ， 而 是 在 从 源 代 码 仓 库 中 获取 的 项 目 基 础 上 开发 。 如 果 是 这 样 ， 就 应 该 选择 这 个 选项 开始 工作 。 


- Open another projecthttp://www.hzcourse.com/resoutce/teadBook? 
path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.... (在 “Rit 列表 的 最 下 面 ) 。 单 击 这 个 链接 会 看 到 一 
标准 的 打开 文件 对 话 框 ， 这 样 你 就 能 选择 任意 想 要 的 项 目 。 也 可 以 用 File 一 Openhttp://www.hzcourse.com/resoutce/readBook? 
path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/... ( HO) 命令 完成 相同 的 工作 。 


如 果 想 要 退回 欢迎 界面 ， 选 择 Window 一 Welcome to Xcode (41) 。 如 果 不 想 再 看 到 这 个 欢迎 界面 ， 取 消 选 择 Show 
this window when Xcode launches 这 个 选项 (只 有 当 刀 标 移 动 到 窗口 上 的 时 候 ， 才 会 显示 这 个 复 选 框 ) 。 


Os Show this window when Xcode lanches 这 名 话 并 不 准确 ， 因 为 如 果 你 最 后 退出 Xcode 的 时 候 还 开 着 一 个 项 目 ， 那 么 当 
你 再 次 启动 Xcode 的 时 候 ， 就 会 重新 打开 这 个 项 目 ， 欢 迎 窗口 就 不 会 再 出 现 。 


2.2 Hello World 


Ate 





由 于 我 们 刚刚 开始 使 用 Xcode， 所 以 我 会 从 一 个 最 简单 的 示例 项 目 开 始 少 编码 工作 。 














2.2.1 新建 项 目 


单 击 Create a new Xcode project 这 个 链接 ，Xcode 会 打开 一 个 空 的 工作 区 窗口 ， 并 且 在 最 前 面 会 显示 新 项 目的 帮助 界面 
( 见 图 2.2) 。 在 左 侧 的 列表 中 选择 OS X 一 Application， 然 后 在 右 侧 选择 命令 行 工 具 (Command Line Tool) MEAR, $ 
击 “ 下 一 步 ” (Next) 按钮 。 


Choose a template fer your new propect: 


DS 
Application -A | J ' 
pplicatior /a TE 


i 


Framework & Library 


| Coma 
her Application 


OS X 
Applicaton 
Framework & Library 
Syeatem Plug-in 
hiner 


Cammand Line Toc 


This template creates a command-fine tool. 


Cancel 





图 2.2 ”新 建 项 目 帮助 界面 会 引导 你 创建 一 个 Xcode 项 目 。 首 先 ， 你 要 指定 想 要 制作 的 产品 类 型 


下 一 个 面板 (图 2.3) 会 询问 项 目 名 称 和 想 要 的 命令 行 工具 类 


Product Name 
corm, wot 
| je D- ra 

Previous 


Ghoose options for your new project: 
| Helle Worlg 
(Fritz Anderson 


Pe 
LAM NI. k 


Organtation Name 


=. 
hu 


Cirganiz ation ganter 


Bungie ldentliiier 
Language 





图 2.3 新 项 目 帮助 界面 的 Options 面 板 用 于 确定 产品 的 基本 信息 ， 以 及 这 个 产品 所 需要 的 系统 库 支 持 
1) 在 Product Name 栏 中 输入 Hello World。 这 个 名 称 会 用 于 项 目 名 称 和 主 产 品 (principal product) 的 名 称 。 
2) Xcode 会 根据 地 址 簿 中 “我 ”的 那 一 项 信息 ， 帮 你 自动 填写 Organization Name 这 一 栏 。 如 果 你 在 地 址 秒 的 信息 中 列 出 


了 所 在 的 公司 ， 那 么 这 个 位 置 束 会 填 上 对 应 的 公司 名 称 。 否 则 ， 这 个 位 置 会 填写 你 个 人 的 名 字 。Xcode 将 这 个 信息 作为 所 有 文件 


的 版 权 所 有 者 (copyright holder) 。 


3) 事实 上 ，OS X 和 iOS 中 所 有 可 执行 文件 都 有 reverse-DNS 风 格 标识 符 用 于 唯一 标识 。Organization ldentifier 是 这 个 
5) 弹出 的 Language 选 项 会 提示 Xcode 这 个 工具 将 会 使 用 什么 系统 库 。 我 们 这 个 项 目 仅 仪 是 一 个 纯 C 程 序 ， 不 需要 C++ 或 


reverse-DNS 名 称 的 开头 部 分 ， 它 会 用 于 这 个 项 目 中 的 所 有 产品 。 比 如 说 ， 我 的 Organizaiton Identifier 栏 填写 的 是 
4) 默认 情况 下 ，Xcode 会 根据 公司 标识 符 和 产品 名 称 推断 出 唯一 的 Bundle Identifier。 后 面 ， 你 会 看 到 如 何 自行 更 改 包 标 


com.wt9t, 


识 符 。 
者 Apple 特 定 的 支持 ， 所 以 选择 C。 
如 果 这 时 查看 桌面 ， 你 会 发 现 Xcode 已 经 创建 了 一 个 名 为 Hello World 的 文件 夹 。 这 个 名 称 将 会 用 在 很 多 地 方 。 


Flo 


na 
单 击 Next 按 钮 ， 会 出 现 一 个 保存 文件 的 对 话 框 ， 让 你 选择 项 目 文件 存放 的 位 置 。 在 这 个 例子 中 ， 选 择 果 面 (Desktop) 。 
还 有 一 点 要 注意 ， 不 要 勾 选 Create Git repository onhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 这 个 选项 。 源 代码 控制 (第 7 章 ) 是 件 好 事 ， 但 
是 在 这 个 小 小 的 示例 项 目 中 先 不 要 使 用 它 。 最 后 单 击 Create 按 钮 。 
tatget 的 概念 ， 现 在 ， 可 以 将 它 视 为 生成 产品 所 需要 的 文件 集合 ， 以 及 指定 


包含 项 目 文件 的 文件 夹 名 。 
它 是 项 目 文档 文件 (Hello World.xcodeproj) 本 身 的 名 称 。 


它 是 产品 的 名 称 ， 在 这 个 例子 中 是 名 称 为 Hello World 的 命令 行 工 
会 介绍 


它 是 构建 产品 的 tatget 的 名 称 。 在 后 面 我 


如 何 构 建 的 说 明文 档 (specification) 。 


ERA RAY target A KA ZAK. 


当 你 在 指定 位 置 创建 好 项 目 之 后 ，Xcode 中 就 可 以 显示 出 Hello World 项 目的 工作 区 见 图 2.4。 先 不 用 细致 地 研究 这 个 界 
面 ，Xcode 先 为 大 家 展示 了 控制 Hello World 如 何 构 建 的 设置 。 这 里 面 显 示 的 都 是 非常 有 用 的 信息 ， 但 是 现在 ， 对 我 们 来 说 它 只 
是 一 些 详细 信息 。 
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A2.4 一旦 建立 好 项 目 ，Hello World 项 目 窗口 就 会 显示 出 一 个 源 文件 列表 ， 以 及 用 于 控制 应 用 程序 如 何 构 建 的 选项 信息 


更 有 趣 的 是 程序 代码 本 身 。 窗 口 的 左边 被 称 为 导航 区 域 (Navigator area) 。 在 列表 中 找到 main.c 这 个 文件 ， 单 击 它 ， 见 
图 2.5。 占 扬 了 项 目 窗口 大 部 分 空间 的 编辑 区 域 (Editor area) 就 会 显示 出 main.c 的 内 容 ， 这 是 一 个 规范 上 且 可 能 是 最 简单 的 程序 
代码 ， 也 就 是 众所周知 的 Hello，World。 


BE Hallo worki ; rh 


— pu Hello World i 
D, aget, OS * SOK 10.10 i F malir. 


Y [| Hello World 2 /f Hello 


Create 


¥ | | Products Lapyir 


Halln World 





图 2.5 在 项 目的 导航 区 域 单 击 一 个 可 编辑 的 文件 名 ， 就 会 在 右 侧 的 编辑 区 域 显示 这 个 文件 的 内 容 


在 程序 开发 的 过 程 中 ， 导 航 区 域 会 显示 很 多 不 同 的 内 容 ， 而 不 仪 仪 是 一 个 文件 列表 。 它 还 能 显示 分 析 (analyses) 、 搜 索 
(searches) 和 构建 日 志 (build logs) 。 这 里 显示 什么 依赖 于 Xcode 想 要 为 你 展示 什么 。 你 也 可 以 通过 单 击 导航 区 域 顶 栏 的 小 
图 标 自主 选择 显示 什么 内 容 。 鼠 标 悬 停 在 这 些小 图 标 上 ， 就 会 显示 出 不 同 视图 的 名 称 。 


随 着 本 书 内 容 的 继续 ， 你 会 看 到 所 有 这 些 视图 的 使 用 。 现 在 ,你 仅 需 天 心 Xcode 显 示 文 件 列 表 的 “项 目 ” 导 航 器 。 可 以 随意 
单 击 其 他 图 标 ， 但 是 为 了 和 示例 代码 保持 一 至， 请 确保 回 到 项 目 导航 器 ， 残 像 图 2.5 所 示 的 那样 。 


2.2.2 ”让 Xcode 安静 下 来 


首先 我 们 要 承认 ，Xcode 是 一 个 针对 iOS 和 OS X 应 用 程序 开发 的 强大 工具 集 ， 包 含 了 制作 者 想 要 使 用 的 各 种 实用 工具 。 通 党 
很 少 需 要 自己 执行 一 项 任务 ，Xcode 会 主动 帮 你 完成 。 一 般 来 说 ，Xcode 这 样 做 没有 问题 。 我 经 常 使 用 这 些 特性 ， 我 也 推荐 使 用 


但 是 现在 需要 马上 将 这 些 功能 都 关闭。 


一 旦 你 知道 自动 补 全 和 缩 进 (automatic completions and indentations) 、 代 码 美化 (code decorations) 和 代码 修复 
(code fix) 这 些 功能 的 作用 ， 你 融会 上 友 现 这 些 功能 都 非 党 优秀。 虽然 目 动 化 会 让 你 的 双手 从 工作 中 解放 出 来 ， 节 省 了 很 多 时 
间 ， 但 是 整个 过 程 却 像 变 戏法 一 样 ， 你 可 能 并 不 完全 了 解 其 中 的 过 程 。 一 开始 ， 最 好 从 你 想 要 什么 做 起 ， 一 旦 对 所 做 的 事 胸 有 成 

竹 ， 束 可 以 考虑 使 用 Xcode 提供 的 功能 帮 你 完成 这 些 工 作 。 


所 以 现在 你 需要 将 Xcode 的 部 分 功能 禁 掉 。 在 Xcode 的 偏好 (Preference) 窗口 中 能 完成 这 些 操作 ， 通 过 
Xcode 一 Preferences (#comma) 就 可 以 进入 这 个 窗口 。 偏 好 窗口 被 划分 为 多 个 面板 ， 你 可 以 在 窗口 的 顶部 单 击 图 标 在 面板 之 
间 切 换 。 


开始 设置 之 前 ， 请 确保 General 标 签 可 见 。 在 lssues 中 ， 取 消 选 择 Show live issues 这 个 选项 。 


接 下 来 ， 选 择 Test Editing 面 板 ， 这 个 面板 有 两 个 选项 卡 。 选 择 Editing 选 项 卡 ， 然 后 取消 选择 Show:Code folding ribben 
以 及 Code completion 下 的 所 有 选项 。 


在 Indentation 选 项 卡 下 ， 天 团 Line wrapping:Wrap lines to editor width 以 及 Syntax-aware indenting 选 项 。 


现在 ， 在 探索 Xcode 的 过 程 中 ， 它 基本 上 不 会 帮 你 自动 完成 一 些 工 作 了 。 
2.2.3 ”构建 和 运行 


main.c 这 个 程序 会 正常 运行 ， 但 是 我 们 需要 一 点 小 技巧 让 这 个 程序 的 输出 在 屏幕 上 保持 足够 长 的 时 间 ， 这 样 才能 看 清楚 输 
出 的 内 容 。 在 printf 之 后 添加 几 行 ， 看 起 来 束 像 这 样 : 


int main(int argc, const char * argv[]) 
{ 

// insert code here... 

printf ("Hello, World!\n") ; 


[kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
* Pause, so the console doesn't disappear 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxxk/ 

char dummy [128] ; 

fgets (dummy, sizeof (dummy), stdin); 


return 0; 


现在 运行 程序 。 选 择 Product 一 Run (ÆR) 命令 。 


一 个 信息 窗口 (beze) 会 迅速 出 现 ， 告 诉 你 Build Succeeded， 也 就 是 构建 成 功 (如 果 此 时 Xcode 处 于 后 台 ， 那 么 就 会 有 
一 个 通知 栏 出 现 ， 告 诉 你 构建 成 功 ， 并 说 明 构 建成 功 的 项 目 和 产品 是 什么 ) 。 


PALA, 发生 了 什么 ? 


Hello World 是 一 个 控制 台 程 序 ， 它 仪 仪 输出 了 一 些 文 字 ， 没 有 任何 窗口 。Xcode 会 在 调试 区 域 (Debug area) 接管 
Xcode 运行 的 程序 的 控制 台 ， 当 程序 运行 的 时 候 ， 调 试 区 域 会 弹出 ， 见 图 2.6。 调 试 区 域 的 右 侧 有 一 个 控制 台 视 图 ， 里 面 显 
示 “Hello World! ”， 见 图 2.7。 





图 2.6 ”工具 栏 中 的 View 选 择 器 可 以 显示 或 者 隐藏 项 目 窗口 中 的 导航 区 (Navigator) ~ HIAR (Debug) 和 工具 区 (Utility) 。 单 
击 对 应 的 按钮 ， 它 就 会 高 亮 ， 并 显示 出 对 应 的 区 域 。 在 这 里 ， 我 们 选择 了 显示 导航 区 和 调试 区 


No Selection 


Hello, World! 
Program ended with exit code: 





All Output + 
图 2.7 运行 Hello World 后 打开 的 调试 区 域 会 显示 同名 的 输出 
单 击 控制 台 ， 让 它 做 好 接受 文本 输入 的 准备 ， 然 后 按 Return 键 。 程 序 Hello World 就 会 退出 ， 同 时 调试 区 域 也 会 关闭 。 


StS 如 果 调试 区 域 在 应 用 程序 结束 的 时 候 没有 隐藏 ， 我 们 可 能 不 需要 添加 fget0 这 个 函数 调用 。 这 一 点 很 容易 更 改 ， 见 


第 4 章 中 的 4.3.1 节 。 


2.2.4 货真价实 的 程序 


Xcode 生成 的 是 一 个 货真价实 且 可 执行 的 应 用 程序 ， 而 不 是 一 个 模拟 程序 。 为 了 证 明 这 一 操 ， 打 开 终 端 程序 (Terminal 
application， 它 位 于 /Applications/Utilities/Terminal 这 个 路 径 下 ， 建 议 你 最 好 将 这 个 程序 拖 入 Dock 栏 中 ) 。 在 Xcode 的 项 目 
导航 区 域 单 击 产品 文件 夹 图 标 旁 边 的 提示 三 角 ， 找 到 Hello World 这 个 产品 。 将 Hello World 的 图 标 拖 入 终端 窗口 中 ， 切 换 到 终 
rig, FIBRE (构建 产品 时 生成 的 文件 处 于 文件 夹 的 深 处， 这 个 文件 的 路 径 相当 长 ， 但 是 终端 会 很 好 地 处 理 这 个 问题 ) ， 融 会 出 
现 “Hello World! ” 


如 果 你 想 要 直接 访问 可 执行 文件 本 身 ， 那 么 在 项 目 导航 器 中 选中 它 ， 然 后 选择 File 乙 Show in Finder 命 令 一 一 也 可 以 在 上 下 
文 菜单 中 石 击 Hello World 图 标 找 到 相同 的 命令 。Finder 殊 会 打开 一 个 文件 所 在 文件 夹 的 新 窗口 。 


大 功 告 成 ! 关闭 工作 区 窗口 (使 用 File 一 Close ProjecttsS, VAW) 或 者 完全 退出 Xcode (使 用 Xcode 一 Quit Xcode 命 
$, #Q). 


2.3 删除 项 目 


Xcode 项 目 一 点 都 不 神秘 ， 它 只 不 过 是 硬盘 中 的 一 个 文件 来 。 如 果 不 册 需 要 这 个 项 目 ， 关 闭 项 目 ， 在 Finder 中 选中 项 目 所 在 
的 文件 夹 ， 将 它 拖 入 到 垃圾 桶 (Trash) 中 即 可 。 这 个 项 目 甚 至 都 不 会 再 出 现在 Xcode Welcome 界 面 最 近 的 项 目 列表 中 ， 也 不 
会 出 现在 File 一 Open Recent 荣 音 中 。 

就 这 么 简单 。 

响 ， 项 目 构 建生 成 的 临时 文件 还 处 于 ~/LibrarWDeveloperXcode/DerivedData 下 庞杂 的 文件 夹 中 。 在 这 个 示例 中 ， 生 成 
的 临时 文件 既 不 大 也 不 多 ， 但 是 这 里 涉及 一 个 基本 原则 。 


如 果 想 要 删除 这 些 文 件 ， 最 好 的 方法 就 是 关闭 项 目 窗 口 ， 打 开 Organizer 窗 口 (Window 一 Organizer) 选择 Projects 面 
板 ， 再 选择 项 目 Hello World， 然 后 按 delete 键 ， 在 弹出 的 警告 框 中 进行 确认 ， 这 样 项 目 构建 生成 时 的 痕迹 都 会 消失 。 


24 小 结 


在 本 章 ， 我 们 初步 了 解 了 Xcode， 你 会 友 现 使 用 起 来 也 不 是 很 复杂 。 我 们 了 解 了 如 何 创建 一 个 简 蛙 的 项 目 ， 这 个 项 目 甚至 都 
不 需要 你 去 编辑 。 知 道 了 在 Xcode 中 运行 项 目的 时 候 会 友 生 什 么 ; 如何 天 闭 一 个 项 目 及 如 何 退 出 Xcode。 最 后 ， 还 学 习 了 如 何 删 
除 与 整个 项 目 相关 的 文件 。 


接 下 来 ， 让 我 们 开始 做 一 些 实际 工作 。 


Spf ”人 科 蛙 的 工作 流程 和 被 动 调试 


本 草 我 们 开始 认真 学 习 使 用 Xcode。 现 在 ， 我 会 引入 一 个 问题 ， 这 个 问题 将 会 贯穿 本 书 所 有 的 示例 代码 。 


这 个 问题 残 是 计算 passer ratings (FSD) 。 人 在 美国 /加 拿 大 的 橄 榴 球 比赛 中 ， 四 分 卫 需 要 将 球 扔 给 ( 传 给 ) 其 他 球 
员 。 当 球 被 传 出 (yardage, RY) 后 可 能 会 越过 球门 线 (touchdown， 游 戏 的 目标 ) 。 传 球 的 过 程 中 ， 球 可 能 会 被 四 分 
卫 所 在 队伍 的 成 员 获 得 (received， 这 个 是 好 事 ) ; 它 也 有 可 能 被 对 方 成 员 接 住 (intercepted, JFE) 。 


但 是 这 里 涉及 4 个 数字 ， 而 每 个 人 都 想得到 一 个 品质 因数 (figure-of-merit) ， 用 这 个 单一 度量 值 来 衡量 (有 可 能 准确 ， 也 
有 可 能 不 准确 ) HERRERA. SEEKERS (National Football League) 和 加 拿 大 橄 析 球 联盟 (Canadia Football 
League) 有 一 个 计算 传 球 手 评分 的 公式 ， 这 个 评分 值 的 范围 是 0~158.3 (很 奇怪 的 数字 ) 。 如 果 四 分 卫 的 评分 能 达到 100， 就 说 
明 他 今天 的 表现 很 抢眼 。 


3.1 ”创建 项 目 


在 第 2 章 ， 我 们 学 习 了 创建 一 个 命令 行 项 目 。 启 动 Xcode 并 选择 Create a new Xcode project， 或 者 选择 File 一 New 一 New 
Projecthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 命 令 (TN) ， 在 新 项 目 帮助 界面 ， 选 择 OS X 


命令 行程 序 ， 将 这 个 工具 命名 为 passer-rating; Language 这 一 项 仍然 选择 C。 


与 第 2 章 不 同 的 一 点 是 ， 当 进入 选择 新 项 目 存 放 位 置 的 界面 时 ， 勾 选 Create Git repository on 这 个 选项 ， 然 后 选择 My 
Mac。Git 是 一 个 版 本 控制 系统 ， 它 是 现代 开发 过 程 中 非常 重要 的 一 部 分 。 虽 然 在 第 7 章 中 你 会 学 习 到 更 多 相关 知识 ， 但 是 现在 是 
时 候 接 触 它 了 。 


9 注意 ”你 曾经 打算 更 改 项 目 中 的 任何 内 容 吗 ? 将 这 些 改动 置 于 版 本 控制 之 下 ， 工 作成 果 会 更 加 安全 ， 也 会 做 得 更 快 。 
之 后 ， 束 会 看 到 target 设 置 界面 ， 这 个 可 以 先 忽 略 。 将 鼠标 移动 到 工作 空间 左 侧 的 项 目 导航 器 中 ， 选 择 main.c 这 个 文件 。 


删除 main0 钞 数 中 除了 外 层 大 括号 以 外 所 有 的 内 容 ， 然 后 蔡 换 函数 的 内 容 ， 使 其 看 起 来 像 这 样 (保留 文件 上 部 的 注释 ) : 


#include <stdio.h> 
#include "rating.h" // Yet to create; initially an error 


int main(int argc, const char * argv[]) 
{ 


int nArgs; 


Ine comps, atts, yards, TDs; 
printf ("comps, atts, yards, TDs: "); 


nArgs = scanf("%d %d %d %d %d", 
&comps, &atts, &yards, &TDs) ; 
if (nArgs == 5) { 


float rating = passer_rating(comps, atts, yards, TDs); 
printf ("Rating = %.1f\n", rating); 
} 
} while (nArgs == 5); 


return 0; 


你 会 注意 到 当 输 入 右 圆 括号 、 右 方 括号 和 石 大 括号 的 时 候 ， 与 其 对 应 的 括号 都 会 黄色 局 腕 显示 。 


平分 本 身 的 计算 过 程 非常 简单 ， 把 这 个 计算 过 程 放 到 单独 的 文件 中 : 选择 
File>New—Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/...as (ÆN) ， 就 会 出 现 新 文件 帮助 界面 ， 见 图 
3.1。 导 航 到 左 侧 的 源 文 件 询 表 和 右 侧 的 图 标 序 列 ， 选 择 : OS X>Source>C File, 


单 击 Next 控 钮 ， 在 保存 文件 的 对 话 框 中 将 文件 命名 为 rating (Xcode 会 目 动 添加 .c 后 缀 ) 。 


Choose a tamplate for your new file: 
IOS. : b l 
Source | L- | oO 
User Interface | 


Core Data Cocoa Class Test Case Class Playground Swift Fila 


T A Cr 
Objestive-C File Header File C++ File 
User interlace 
Core Data 


Resource C File 
Other 


An empty © file. 





图 3.1 创建 新 文件 的 时 候 ， 新 文件 帮助 界面 提供 很 多 可 以 使 用 的 模板 。 从 左边 的 源 文件 列表 中 选择 类 别 ， 然 后 再 从 右 侧 的 图 标 
序列 中 选择 一 个 模板 


保存 文件 对 话 框 中 有 两 个 选项 ，Group (组 ) 选项 能 让 你 将 一 个 新 文件 放 入 项 目 导 舰 器 中 (项 目 窗口 左 侧 的 资源 列表 ) 。 简 


单 地 说 ， 组 是 组 织 项 目 列表 最 简单 的 方式 。 它 对 新 文件 在 磁盘 上 是 如 何 存 储 的 没有 任何 有 影响。 确保 选中 了 passer-rating 这 个 
组 。 


第 二 个 选项 是 Targets， 它 是 一 个 表格 ， 目 前 只 包含 一 行 passer-rating。target 指 的 是 用 于 构建 一 个 产品 的 一 组 文件 和 设 
置 。 不 属于 target 的 文件 不 会 用 来 构建 target 对 应 的 产品 。 请 确保 勾 选 了 passer-rating 选 项 。 


Os 很 容易 忽略 指定 正确 的 tafget。Xcode 6 对 于 添加 到 项 目 中 的 文件 ， 默 认 都 设置 为 上 次 添加 文件 指定 的 tatget。 如 果 
忘记 了 选择 合适 的 tareet， 可 能 直到 应 用 程序 构建 失败 或 者 因为 没有 包含 所 需要 的 资源 而 导致 英名 其 妨 的 衣 溃 时 ， 你 才 会 注意 到 
没有 选择 target。 


rating.c 的 代码 如 下 所 示 : 


#include "rating.h" 


static 
double pinPassingComponent (double component) 
{ 
if (component < 0.0) 
return 0.0; 
else if (component > 2.375) 
teturn ‘4.4757 
else 
return component; 


float 


passer_rating(int comps, int atts, int yds, int tds, int ints) 
{ 
// See http://en.wikipedia.org/wiki/Quarterback_Rating 


double completionComponent = 
(((double) comps / atts) * 100.0 - 30.0) / 20.0; 
completionComponent = pinPassingComponent (completionComponent) ; 
double yardageComponent = 
(((double) yds / atts) - 0.3) / 4.0; 
// intentional bug 
yardageComponent = pinPassingComponent (yardageComponent) ; 


double touchdownComponent = 
20.0 * (double) tds / atts; 
touchdownComponent = pinPassingComponent (touchdownComponent) ; 


double pickComponent = 
2.375 - (25.0 * (double) ints / atts); 
pickComponent = pinPassingComponent (pickComponent) ; 


double retval = 100.0 * (completionComponent + 
yardageComponent + 
touchdownComponent + 
pickComponent) / 6.0; 
return retval; 


到 现在 为 止 ， 你 遗漏 了 一 对 括号 ， 也 厌倦 了 通过 键入 制 表 符 的 方式 来 添加 额外 的 缩 进 。Xcode 可 以 帮 你 做 到 这 一 点 ， 这 个 功 
能 也 在 上 章 我 让 你 关闭 的 功能 当中 。 


Oza 在 这 段 代 码 中 ， 你 会 发 现 一 些 pug， 很 好 。 为 了 介绍 调试 技巧 ， 在 本 书 中 我 会 给 出 一 些 有 问题 的 代码 。 跟 着 我 的 节 
BR, AFA? 


打开 偏好 窗口 (Xcode—>Preferences S #Æcomma) ， 选 择 Text Editing 面 板 。 在 Editing 选 项 卡 下 ， 勾 选 Code 
completion:Automatically insert closing 人”。 在 Indentation 选 项 有 卡 下 ， 勾 选 Systax-ware indenting: Automatically 


indent based on syntax, 


现在 在 代码 中 一 行 的 末尾 输入 一 个 左 大 括号 ， 按 回 车 键 ，Xcode 就 会 添加 两 行 : 鼠标 的 位 置 在 第 一 行 ， 这 一 行 缩 进 了 一 级 。 
其 下 还 有 一 行 ， 这 一 行 有 一 个 与 左 大 括号 相对 应 的 右 大 括号 。 


最 后 ， 你 会 发 现 main.c 和 rating.c 都 引用 了 rating.h， 这 个 文件 告诉 main() 国 数 passer rating hFE. FRANDS, 
从 代码 中 选择 头 文件 模板 ， 将 其 命名 为 rating， 在 这 个 头 文 件 中 写 入 如 下 代码 : 


#ifndef passer_rating_rating_h 
#define passer_rating_rating_h 


float passer_rating(int comps, int atts, int yds, 


int’ tdas, int ite): 
tendif 


Ore 头 文件 可 以 放 到 项 目 组 中 的 任意 位 置 ， 但 是 不 要 将 它们 添加 到 任何 target 中 。 这 个 规则 有 些 例外 情况 ， 如 果真 的 需 
要 这 么 做 ， 你 会 知道 为 什么 要 这 么 做 。 第 6 章 中 有 详细 介绍 。 


单 击 Create。 


3.2 构建 


现在 可 以 开始 尝试 运行 这 个 程序 。 很 简单 ， 单 击 工具 栏 最 左 侧 的 Run 按 钮 ， 或 者 使 用 Product 一 Run (ÆR) 命令 。 如 果 你 
没有 保存 所 做 的 工作 也 没有 关系 ， 因 为 在 构建 项 目 之 前 ，Xcode 会 默认 保存 所 有 文件 。Xcode 编 译 了 一 下 代码 ， 然 后 停止 了 运 
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1To 
- Xcode 顶部 有 个 提示 框 一 闪 而 过 ， 上 面 写 着 Build Failed (构建 失败 。) 


` 导航 区 现在 切换 到 了 事件 导航 器 ， 在 main.c 文 件 下 有 两 项 (如果 事件 导航 器 没有 出 现 ， 单 击 导 航 区 域 上 方 的 第 四 个 按钮 即 
T) 。 其 中 一 项 前 面 标记 着 黄色 三 角 (ES) ， 另 外 一 个 标记 着 红色 八角 形 (错误 ) 。 这 两 项 下 面 都 有 针对 错误 的 描述 见 图 3.2 


Dy 


- 当 你 单 击 其 中 的 一 项 ，main.c 中 会 有 两 行 被 高 之 显示。 触发 警告 的 那 一 行 被 标记 为 黄色 ， 同 时 还 有 一 个 描述 警告 内 容 的 信 
息 框 ; 触发 错误 的 那 一 行 被 标记 为 红色 ， 也 有 一 个 对 应 的 信息 框 ， 见 图 3.2 右 。 


O fe q 
By File | By Type | 
passer-rating 
¥ = 2 asus 


F di Format String Issue 
. More "%' conversions than data arguments 
main. 


printT("comps, atts, yards, TDs, INTs: "), 
A 18 nArgs = scant("sd +d sd +d wd"", More ‘4' conversions than data arguments 
¥ @ Semantic Issue 19 &comps, &atts, Syards, &TDs}: 
HO Too few arguments to function call, expected 20 if (nArgs == 5) { 
5, have 4 1 float rating = passer_rating(comps, atts, 
main.c B12 yards, TDs); 
j printf{"Rating = %.1f\n", rating); (100 few arguments to function call, expaciea.. 














图 3.2 (Æ) 当 Xcode 检 测 到 构建 错误 的 时 候 ， 它 就 会 打开 事件 导航 器 显示 出 这 些 错误 。 ( 右 ) 单 击 一 个 事件 ， 编 辑 器 就 会 跳 转 
到 事件 对 应 的 文件 和 行 号 


我 记得 唯一 与 截取 相关 的 代码 就 是 scanf 调 用 中 的 格式 化 字符 串 。 编 译 器 很 聪明 ， 它 能 匹配 格式 描述 字符 串 中 需要 的 参数 与 
实际 提供 的 参数 ， 并 在 不 匹配 的 时 候 发 出 敬告。 代码 中 的 实际 情况 与 我 的 猜测 很 相似 ， 在 pass _rating 的 调用 中 ， 我 少 写 了 一 个 
参数 ， 这 是 一 个 很 明显 的 错误 。 


全 注意 对 于 编译 器 来 说 ， 错 误 (error) 是 源 文 件 中 很 严重 的 问题 ， 错 误会 导致 编译 器 无 法 将 代码 编译 成 可 执行 程序 。 即 
便 是 只 有 一 个 错误 ，Xcode 也 无 法 正 第 生成 一 个 程序 。 警 告 (warning) 说 明代 码 可 以 编译 成 可 执行 程序 ,但 是 在 运行 的 过 程 中 很 
可 能 会 出 现 程序 运行 不 正常 或 者 关 溃 的 情况 。 有 经 验 的 开发 者 不 会 放 过 任何 一 个 警告 ， 编 译 器 其 至 有 一 个 选项 ， 即 便 只 出 现 警 
而 没有 错误 的 时 候 ， 也 让 编译 失败 。 绝 对 不 要 放 过 任何 一 个 警告 。 


已 


Og 4h Kpasser_rating yy SAAN BP? 尝试 这 样 做 : 当 main 文 件 出 现在 编辑 区 域 (Editor area) 的 时 候 ， 按 
Command 键 并 将 鼠标 放 到 passef_fating 这 个 字符 串 上 。 你 会 发 现 这 个 字段 已 经 变 为 蓝 色 ， 并 且 其 下 出 现 了 一 条 下 划 线 ， 就 像 网 页 
中 的 链接 一 样 。 单 击 这 个 字符 串 ， 编 辑 器 就 会 跳 转 到 passet rating 声明 的 位 置 。 单 击 编辑 器 左上 角 的 向 后 按钮 或 ^ 且 一 就 能 返回 之 
前 的 位 置 ， 如 果 在 系统 偏好 中 设置 了 对 应 的 后 退 手势 ， 也 可 以 在 触摸 板 上 用 两 指向 右 滑动 实现 后 退 操 作 ( 单 击 函 数 名 会 出 现 一 个 


荐 浮 框 ， 它 会 告诉 你 沪 数 passer_rating 声 明 在 frating.h 这 个 文件 中 。 更 多 内 容 见 第 24 章 ) 。 
这 两 个 问题 可 以 迅速 修复 。 


do { 
int comps, atts, yards, TDs, INTs; 
printf("comps, atts, yards, TDs, INTs: "); 
nArgs = scanf("%d %d %d %d %d", 
&comps, &atts, &yards, &TDs, INTs); 
if (nArgs == 5) { 


float rating = passer_rating(comps, atts, yards, 
TDs, INTs); 
printf ("Rating = %.1f\n", rating); 
} 
} while (nArgs == 5); 


保守 起 见 (我 不 想 在 还 有 警告 的 时 候 运 行程 序 ) ， 使 用 命令 Product 一 Build (éB) 编译 并 链接 passer-rating， 但 不 运行 
它 。 不 用 担心 ， 现 在 程序 能 够 编译 成 功 ， 且 没有 错误 。 


Gig ”事件 导航 器 中 可 能 会 显示 一 两 个 警告 ， 我 们 先 假装 没有 看 到 ， 继 续 下 面 的 工作 。 


现在 已 经 有 了 可 以 运行 的 程序 ， 运 行 它 (Run 按钮 处 于 工具 栏 的 第 一 个 位 置 ; 或 者 按 快捷 键 纯 R) 。 


这 里 有 一 个 界面 转换 过 程 : 调试 区 域 出 现在 窗口 的 底部 ， 同 时 工具 栏 中 的 View 控 件 中 间 的 按钮 会 高 亮 显 示 ， 标 识 现 在 显示 
了 调试 区 域 ， 见 图 3.3。 
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图 3.3 ÆXcode F 2 4F— FE FF 
调试 区 域 的 右 半 侧 是 一 个 控制 台 


comps, atts, yards, TDs, INTs: 


显示 的 这 些 字符 就 是 printf(0 这 个 国 数 的 输出 ，pass-rating 正 在 等 全 
10 20 85 1 0 <return> 
出 现 了 一 些 | 问 题 。passer-rating 朋 演 了 。 调 试 引 党 


显示 程序 崩 


这 个 工具 非常 实用 ie) 现在 先 不 管 它 。 


. 在 导航 区 域 ， 会 出 现 调 试 导航 器 ， 


构建 一 些 很 复杂 的 项 目 时 ， 


面 还 有 一 个 栈 仍 味 器 ， 显 示 程 序 衣 江 时 调用 的 消 数 链 。 最 上 面 标 记 为 0， 显 示 的 是 程序 衣 江 时 运行 的 消 


如 果 单 击 这 一 行 ， 你 将 会 看 到 程序 有 骨 溃 时 所 在 的 汇编 代码 
main 了 数 中 调用 的 六 数 。Xcode 将 main 函 数 的 调用 用 一 个 
行 ， 就 会 看 到 当 程 序 朋 省 时 的 代码 。 


svfscanf 1。 


窗口 的 底部 调试 区 域 的 左 侧 用 来 显示 变量 名 和 值 。 


详细 讨论 这 个 问题 。 


编辑 器 区 域 中 有 一 个 变化 最 有 意思 ， 它 
提示 框 中 写 着 : Thread 1:EXC_BAD_ACCESS (code=1, 


上 ， 就 能 看 到 完整 的 提示 


address=0x0 ) 


信息 文本 。 


Ose Xcode 中 有 很 多 这 种 提 ; 
时 候 很 舒适 ， 也 能 一 次 性 看 到 更 多 信息 


Het 


| paeser-rating 


7014 User 


argc, Const 


comps, atts, yards, 
ATTS i 
Scantt™sd +d èd sd wd", 

&comps, atts, Byards, &TDS, INTs); 


rating 


printf("Rating = %.1f 





序 会 打开 调试 区 域 (调试 区 域 处 于 项 目 窗 


， 你 可 以 使 用 它 与 passer-rating 通 


MATAR A FAM 


监 色 头 肩 的 图 标 表 示 ， 表 示 它 


比如 说 ， 你 能 看 到 atts=(inb20 ， 


能 够 传递 重要 信息 的 方法 。 你 可 以 把 字体 适当 调 小 ， 
， 而 且 它 的 边框 也 占据 了 一 些 位 置 ， 所 以 其 中 的 字体 可 能 太 小 ， 


El main. main) Š 


reserved, 


char + argv[])} 


TOs, INTs; 
INTS; "Je 
Thread 1: EXC BAD ACCESS [edgdeal, 加 中 99 


Yards, TOS, 


Format species type ‘ini but the argument has type "int' 
= passer_rating(comps, atts, yards, 
TOs, INTS); 
rating}; 


Yn a 


国 pascer-rating ) Wi Thread 1 » [H 2 main 


| conps, atts, yards, TDs, INTS: 10 28 iS 1 g 


{lldb 

















口 的 底部 ) 
言 。 如 果 一 切 顺 利 ， 它 会 显示 如 下 所 示 的 内 容 : 


寺 输 入 ， 单 击 控制 面板 并 输入 : 


lldb 会 接管 程序 ， 同 时 显示 出 调试 信息 。 


部 有 一 个 性 能 条 形 图 (performance bar chart) 当 你 


NAIR: -- 
下 一 行 是 scanf， 它 是 你 在 


是 现在 正在 进行 的 工作 。 单 击 这 一 


(因为 源 文件 并 不 可 用 ) 。 


它 就 是 你 刚才 输入 的 数字 。 第 4 章 将 会 


左 侧 的 空白 区 域 会 出 现 一 个 绿色 的 标记 ， 在 scanf 调 用 的 右 侧 有 一 个 绿色 的 提示 框 。 


这 里 面 的 信息 可 能 会 被 截断 ， 如 果 把 鼠标 移动 到 提示 杠 


这 样 在 阅读 的 


阅读 


不 便 。 唯 一 的 解决 方案 就 是 在 日 常 工作 中 选择 大 一 点 的 字体 ， 相 关 的 设置 在 偏好 窗口 的 Fonts&Colors 面 板 中 。 


3.4 简单 调试 


EXC_BAD_ACCESS 告 诉 我 们 使 用 了 一 个 错误 的 指针 ， 这 个 指针 也 许 指向 了 一 块 非法 内 存 ， 导 致 无 法 读 取 或 者 写 入 (OS X 和 
现代 iOS 中 64 位 的 虚拟 内 存 管 理 的 设置 是 : 任何 可 能 继承 于 32 位 整数 型 的 指针 都 是 非法 指针 ， 这 让 int 类 型 和 pointer 类 型 很 难 乱 
用 ) 。 重 新 检查 main 阔 数 中 月 省 的 那 一 行 ， 注 意 下 面 这 段 代 码 : 


nArgs = scanf("%d %d %d %d %d", 
&comps, &atts, «yards, &TDs, INTs); 


scanf 这 个 沙 数 从 指针 指向 的 变量 中 获取 值 。 这 个 调用 中 ， 所 有 传 入 的 参数 都 是 指针 类 型 ， 除 了 INT 之 外 ， 它 传 入 的 是 值 类 
型 而 不 是 指针 类 型 。 我 之 前 让 你 忽略 的 一 个 警告 中 已 经 明确 地 说 明了 这 一 点 : Format specifies type ‘(int*)’ , but the 
int”。 修 改 这 个 问题 仅 需 在 INT 前 加 上 取 地 址 待 号 &。 


I 


argument has type 


nArgs = scanf("%d %d %d %d %d", 
&comps, &atts, «yards, «TDs, &INTs) ; 


这 样 就 能 解决 这 个 问题 。 为 了 确保 万 无 一 失 ， 再 次 运行 passer-rating， 发 现 已 经 没有 朋 演 了 。 


comps, atts, yards, TDs, INTs: 10 20 85 1 0 
Rating = 89.4 
comps, atts, yards, TDs, INTs: <\p> 


使 用 快捷 键 ^D， 可 终止 passer-rating 的 输入 等 待 ， 程 序 退 出 ， 并 且 调 斌 区域 也 会 关闭。 


通常 ， 当 Xcode 中 运行 男 一 个 程序 的 时 候 ， 你 可 能 不 想 运 行 或 者 调试 一 个 新 程序 ， 而 是 将 当前 的 应 用 程序 清除 。 有 四 种 方法 
可 以 做 到 这 点 : 


` 简单 地 让 程序 退出 ， 就 像 使 用 ^D 终 止 passer-rating 这 个 程序 一 样 ， 或 者 在 OS X 应 用 程序 中 选择 使 用 Quit 命 令 。 但 是 这 种 方 
法 不 适用 于 iOS 应 用 程序 ， 因 为 OS 应 用 程序 基本 上 从 来 都 不 会 人 退出。 你 必须 要 使 用 另外 的 方法 。 


: 单 击 工具 栏 上 的 Stop 按 钮 。 
- 使 用 Product 一 Stop (4%) 命令 。 


- 让 Xcode 再 运行 一 个 程序 ， 在 出 现 的 警示 框 中 单 击 Stop， 见 图 3.4。 


Sto H "passe r-rati ng Hy 


‘Dasser-rating is already running. Click Stop to 
terminate and launch a new Instance, 


Click Add to launch an additional instance. 


Do not show this message again 


Cancel Ada 





图 3.4 ” 当 Xcode 中 已经 有 程序 在 运行 的 时 候 ， 让 Xcode 再 运行 一 个 应 用 程序 ， 就 会 出 现 一 个 对 话 框 ,询问 如 何 处 理 当前 正在 运行 


的 程序 。 通 第 ， 你 会 单 击 Stop， 但 是 这 里 还 有 一 个 选项 Add， 它 能 让 你 创建 一 个 新 的 示例 ， 与 之 前 的 应 用 程序 同时 运行 


警示 框 中 也 提供 了 一 个 Add 按 钮 ， 使 用 这 个 按钮 可 以 在 不 退出 老 程 序 的 情况 下 ， 运 行 并 调试 新 进程 。Xcode 会 局 动 一 个 新 的 
执行 环境 (execution context) 。 通 过 单 击 调试 区 域 顶 部 的 跳 转 栏 ， 能 够 完成 多 个 应 用 程序 乙 间 的 切换 。 同 时 ， 工 具 栏 中 的 
Stop 按钮 也 会 变 成 一 个 荣 单 ， 可 以 选择 停止 哪个 进程 。 


Ose A & 4) %Do not show this message again 这 个 选项 。 也 许 在 调试 程序 的 时 候 ， 你 可 能 会 想 要 继续 执行 之 前 的 应 用 程 
序 ， 但 是 没有 单 击 调试 器 提供 的 小 按钮 ， 而 是 单 击 工具 栏 中 又 大 又 友好 的 Run 按 钮 ， 对 我 来 说 这 种 情况 经 常 发 生 。 这 个 “添加 新 


应 用 实例 还 是 停止 之 前 的 应 用 ” (add-or-stop) 的 警告 框 是 连接 你 与 销毁 正在 进行 的 调试 会 话 之 间 唯 一 的 桥梁 。 


现在 一 切 正常 : 当 标 准 输入 流 结 束 的 时 候 ，scanf 调 用 会 返回 小 于 5 个 的 输入 。 在 终端 中 运行 程序 的 时 候 ， 可 以 使 用 ^D 结 束 
程序 。 


Ose 项 目 导 航 器 中 的 M 和 A 标记 会 逐渐 增多 。 它 们 与 版 本 控制 有 关 。 不 要 担心 ， 耐 心 点 ， 我 会 在 第 7 章 中 介绍 这 些 内 


yy 


本 章 市 领 大 家 编写 并 运行 了 目 己 的 程序 。 其 中 介绍 了 最 初级 的 调试 技术 : 当 程 序 衣 演 的 时 候 该 怎么 做 。Xcode 提 供 了 非常 实 
用 的 工具 ， 能 够 帮助 用 户 分 析 半 省 的 原因 ， 减 轻 用 户 的 工作 量 。 根 据 Xcode 的 提示 ， 能 够 迅速 定位 问题 的 原因 ， 并 且 验 证 修改 的 
正确 性 。 


但 是 passer-rating 这 个 程序 还 是 无 法 正常 运行 ， 它 还 有 很 多 问题 。 这 一 回 你 要 主动 出 击 ， 找 出 这 些 问题 。 


第 4 章 “主动 调试 


passer-rating 运 行程 序 时 已 经 不 会 朋 演 了， 这 是 我 们 的 工作 成 果 ， 不 过 距离 成 功 还 还。 让 我 们 继续 深入 探索 ， 看 看 这 个 程 
序 是 否 能 够 按照 期 待 运行 。 这 需要 一 些小 测试 ， 也 许 还 需要 分 析 一 下 这 个 程序 内 部 的 工作 原理 。 


4.1 一 个 简 早 的 测试 用 例 


再 次 运行 passer-rating。 如 果 你 愿意 ， 可 以 输入 一 些 普通 比赛 的 | 上 日数 据 ， 但 是 也 要 尝试 评估 那些 根本 没有 参加 比 冤 的 四 分 
P. 
comps, atts, yards, TDs, INTs: 10 20 85 1 0 
Rating = 89.4 
comps, atts, yards, TDs, INTs: 00000 


Rating = nan 
comps, atts, yards, TDs, INTs: 


程序 的 输出 结果 似乎 不 理想 。 虽 然 程 序 没 有 半 溃 ， 但 是 结果 却 不 正确 。 如 果 一 个 传 球 手 一 个 球 都 没有 传 过 ， 那 么 评分 应 该 为 
0。 但 是 passer-rating 这 个 程序 却 给 出 了 nan 这 个 评分 ，nan 的 意思 是 说 输出 的 内 容 不 是 一 个 数 子 。 这 束 意 味 着 程序 中 的 数据 计 
算 有 一 些 逻 辑 错 误 。 


现在 ， 让 我 们 使 用 Xcode 调试 器 来 检查 passer-rating 中 到 底 出 了 什么 问题 。 不 要 停止 passer-rating， 不 需要 做 任何 更 改 ， 
调试 器 就 能 调试 你 的 应 用 程序 。 


4.2 ”开始 主动 调试 


上 一 次 ， 在 程序 遇 到 严重 错误 的 时 候 ， 调 试 器 接管 了 程序 。 这 次 ， 你 想 在 指定 的 时 刻 让 调试 器 接管 程序 的 运行 。 在 passer- 
rating 中 指定 的 行 设 定 一 个 断 点 ， 可 以 通知 调试 器 在 这 一 行 暂 停 运行 ， 这 样 可 以 查看 的 变量 信和 执行 结果 都 会 在 你 的 掌控 之 下 。 


4.2.1 RAA 


设置 断 点 最 简单 的 方法 是 单 击 Xcode 源 代码 编辑 器 左 侧 边栏 。 在 项 目 导航 器 中 选中 rating.c， 在 代码 编辑 器 中 打开 。 深 动 到 
passer_rating 函 数 的 第 一 行 ， 单 击 初始 化 completionComponent ( 见 图 4.1， 上 ) 这 一 行 最 左 侧 的 边栏 。 界 面 中 ， 一 个 深蓝 色 
的 箭头 就 会 出 现在 边栏 上 ， 表 示 这 里 设置 了 一 个 断 点 。 将 断 点 从 边栏 中 拖 出 ， 就 会 移 除 断 点 。 在 边栏 中 上 下 移动 断 点 ， 就 可 以 改 
变 断 点 所 在 的 位 置 。 


double completionComponent = 
(((double) comps / atts) * 100.0 - 30.0) / 20.0; 
compLletionComponent = pinPassingComponent(compLletionComponent) ; 


// See http://en.wikipedia,. org/wiki/Quarterback Rating 


double comp letionComponent = 
(((double) comps / atts) * 100.0 - 30.0) / 20.0; 
completionComponent = pinPassingComponent(completionComponent); 





图 4.1 (E) 单 击 编辑 器 左 侧 的 边栏 就 可 以 在 对 应 的 代码 行 设置 断 点 。 当 应 用 程序 运行 到 这 行 的 时 候 ， 就 会 暂停 执行 ， 同 时 调 
试 器 就 会 显示 当前 的 程序 状态 。 (TF) 单 击 一 个 已 激活 的 断 点 ，Xcode 就 会 保存 它 的 位 置 ， 但 是 调试 器 会 忽略 这 个 断 点 。 此 时 在 


编辑 器 中 ， 这 个 箭头 会 显示 为 灰色 ， 表 示 它 处 于 未 激活 状态 


也 可 以 通过 Debug 一 Breakpoints 一 Add Breakpoint at Current Line (¢6\) 命令 ， 在 编辑 器 中 光标 或 者 选择 区 域 所 在 的 
行 设置 断 点 。 


SR 如 果 你 是 一 个 快捷 键 爱好 者 ， 按 昭 n 就 可 以 在 各 个 导航 器 中 切换 ， 这 里 n 是 导航 器 中 选项 卡 对 应 的 数字 。 当 然 ， 你 
还 是 要 用 鼠标 使 用 茶 个 导航 器 中 的 功能 。 


移 除 断 点 有 3 种 方法 。 第 一 种 残 是 简单 地 将 它 从 侧 边栏 中 拖 出 去 ， 不 过 如 果 你 想 要 恢复 这 个 断 点 ， 融 没有 办 法 了 。 因 为 这 个 
操作 不 会 在 你 曾经 感 兴趣 的 这 一 行 留 下 任何 痕迹 。 如 果 你 仅仅 想 禁止 这 个 断 点 而 不 是 删除 这 个 断 点 ， 仪 需要 单 击 这 个 深蓝 色 的 箭 
头 ， 它 束 会 变 为 灰色 ,调试 器 运行 到 这 一 行 的 时 候 束 会 目 动 忽 略 它 ， 见 图 4.1 下 。 


最 后 一 种 方法 ， 在 调试 区 域 的 控制 栏 (在 工具 栏 最 右 端的 View 选 择 器 中 选择 居中 分 割 方式 可 以 显示 出 调试 区 域 ) 中 有 一 个 
按钮 ， 形 状 与 断 点 类 似 ， 这 是 一 个 开关 : 当 它 显示 为 监 色 的 时 候 ， 调 试 器 融 能 触 友 所 有 激活 的 断 点 ; 当 它 显示 为 灰色 的 时 候 ， 调 
试 器 融会 忽略 所 有 断 点 。 不 过 即使 断 点 控制 器 处 于 天 闭 状态 ， 在 程序 朋 溃 时 ， 调 试 器 还 是 会 接管 程 邦 。 


STR 断 点 导航 器 (导航 区 域 中 的 第 7 个 选项 卡 ) 列 出 了 项 目 中 所 有 的 断 点 。 你 可 以 禁止 或 者 删除 断 点 ， 也 可 以 浏览 断 点 
所 在 行 的 代码 。 


你 不 需要 停止 或 者 重新 局 动 应 用 程序 来 激活 调试 功能 : 设置 断 点 并 不 会 更 改 你 的 代码 ， 也 不 会 改变 从 这 些 代码 中 编译 生成 的 
可 执行 程序 。 现 在 ， 断 点 已 经 设置 完毕 ， 回 到 调试 控制 台中 ，passer-rating 仍 然 在 等 待 输入 ， 再 次 输入 5 个 0。 


Xcode 会 触 友 断 点 ， 表 现 与 遇 到 EXC_BAD_ACCE9S9 钳 误 时 一 样 : 调试 器 会 显示 从 main 到 passer_rating 的 调用 堆 枝 轨迹 ， 
调试 区 域 的 左 半边 显示 当前 变量 的 状态 ， 在 编辑 器 中 有 一 个 绿色 的 提示 框 写 着 Thread1: breakpoint1.1。 在 左 侧 空 晶 区域， 断 
扎 所 在 边栏 的 外 侧 有 一 个 绿色 的 箭头 ， 随 着 程序 代码 的 执行 ， 这 个 箭头 丈 会 指向 当前 执行 的 那 一 行 代码 。 


PTR ”调试 区 域 包 含 两 个 窗 格 : 变量 显示 在 左 侧 窗 格 ， 控 制 台 显示 在 右边 。 调 试 区 域 的 右 下 角 有 一 个 控制 器 ， 可 以 选择 


仅 显 示 一 个 窗 格 还 是 两 个 窗 格 都 显示 。 
4.2.2 SERE 


让 我 们 将 注意 力 转 到 变量 窗 格 上 。 这 里 有 5 行 用 紫色 的 A 标记 ， 表 示 这 些 变 量 是 水 数 的 参数 ， 还 有 一 行 用 赣 绿色 的 L 标 记 ， 表 
示 局 部 变量 completionComponent。 这 些 参数 都 显示 为 (int) 0， 刚 好 是 刚才 输入 的 数值 。 局 部 变量 completionCompent 的 


值 也 是 0， 但 是 类 型 为 double。 


稍 等 一 下 ， 本 来 有 不 止 一 个 局 部 变量 。 其 余 的 都 在 哪里 ?调试 器 会 减少 可 见 变量 个 数 ， 只 显示 你 现在 感 兴 趣 的 那些 局 部 变 
量 。yardageComponent 现 在 还 用 不 到 ， 因 为 还 没有 给 它 赋值 ， 你 不 需要 看 到 那些 垃圾 数据 。 如 果 你 想 看 到 所 有 的 数据 ， 使 用 
变量 窗 格 左 下 角 的 弹出 菜单 ， 然 后 选择 Local variables， 见 图 4.2 上 。 

将 所 有 的 局 部 变量 都 显示 出 来 ， 给 某 些 变 量 设置 一 些 值 ， 这 样 当 它们 的 值 友 生 更 改 时 就 会 很 容易 注意 到 : 单 击 每 一 行 ， 然 后 
按 回 车 键 (双击 也 能 达到 同样 的 效果 ) 。 输 入 -1， 然 后 再 次 按 回 车 键 ， 见 图 4.2 下 。 


PR 当 变 量 出 现在 编辑 器 视图 中 的 时 候 ， 还 有 一 种 方法 可 以 查看 变量 的 值 : 将 鼠标 移动 到 一 个 变量 上 ，Xcode 就 会 弹 


出 一 个 悬浮 框 显 示 这 个 变量 的 值 ， 如 果 这 个 变量 是 复杂 类 型 ， 如 structs 或 者 对 象 ， 就 会 显示 出 对 应 的 详细 信息 。 对 于 图 形 化 的 


值 ，QuickLook (eye) 按钮 黄 至 能 显示 出 对 应 的 图 形 。 这 个 功能 非常 强大 ， 有 可 能 会 成 为 你 在 调试 中 的 首选 方法 。 我 之 所 以 喜欢 


使 用 变量 窗 格 来 观察 变量 ， 是 因为 它 能 始终 显示 所 有 的 变量 ， 还 能 在 程序 运行 中 更 改 相应 的 变量 。 


< bm passer-rating ， wm Thread 1: 


i.) comps = (int) 0 

Gi atts = (int) 0 

BY yds = (int) O 

i.) tds = (int) O 

GY ints = (int) 0 

— completionComponent = (double) 0 

| yardageComponent = (double) -2.3782564568885816E-159 
i touchdownComponent = (double) 6.9532229757501794E-310 
| pickComponent = (double) 6.9532229757628278E-310 

i retval = (double) 1.0185579799004622E-312 


<j BE passer-rating > WM Thread 1 


|) comps = (int) 0 

i.) atte = (int) 0 

GJ yde = (int) 0 

CI tds = (int) 0 

GJ ints = (int) 0 

| completionComponent = (doubla) 0 

|- yardageComponent = (double) -2.3782564560805816E-159 
 touchdownComponent = (double) 6.95322297575017S8E-310 
 pickComponent = (double) 6.8532229757628278E-310 


|L retval = (double) 
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图 4.2 (上 ) 将 变量 窗 格 左下 角 的 scroping 选 项 设置 为 Local 时 ， 就 会 看 到 当前 函数 中 所 有 的 参数 和 局 部 变量 。 (下 ) 双击 某 个 变 
量 行 的 值 部 分 ， 就 可 以 在 程序 运行 中 更 改变 量 的 值 


4.2.3” 单 步调 试 


现在 ， 你 已 经 做 好 观察 passer-rating 执 行 过 程 的 准备 了 。 在 变量 窗 格 的 上 面 是 一 个 包含 很 多 控件 的 控制 栏 ， 见 图 4.3。 所 有 
的 控件 在 荣 单 中 都 有 对 应 的 选项 ， 这 些 选项 大 多 数 都 在 Debug 荣 单 中 。 





图 4.3 ”调试 区 域 顶端 的 操作 栏 提供 了 很 多 推进 程序 执行 以 及 浏览 程序 状态 的 控件 


1) Hide/Show Debug Area (TY) 按钮 ， 可 以 隐藏 调试 区 域 仅 留 下 控制 栏 ， 再 次 单 击 就 能 重新 展开 调试 区 域 。 
2) Activate/Deactivate Breakpoints (#Y) 按钮 可 以 启用 或 者 禁用 项 目 中 的 所 有 上 断 点 。 

3) Continue (*¢ébY) 能 让 程序 继续 运行 ， 直 到 遇 到 下 一 个 断 点 或 者 骨 溃 。 

4) Step Over (F6) 执行 当前 行 ， 并 在 下 一 行 停止 执行 。 

5) Step Into (F7) 继续 执行 ， 直 到 进入 本 行 调用 的 下 一 个 亢 数 ; 并 在 那个 函数 的 第 一 行 恢 复 控制 权 。 

6) Step Out (F8) 继续 执行 ， 直 到 离开 当前 溺 数 ， 在 调用 这 个 立 数 的 地 方 可 以 恢复 控制 权 ，。 


7) Simulate Location 当 应 用 程序 使 用 Core Location 这 个 功能 的 时 候 ， 这 个 选项 可 以 设置 应 用 程序 的 地 点 。 这 是 一 个 弹出 
菜单 ， 里 面 有 很 多 世界 上 常见 的 位 置 。 你 也 可 以 提供 一 个 JSON 格 式 的 GPX 摘 述 文件 来 指定 自 定 义 的 位 置 。 


8) 跳 转 栏 用 于 追 踊 程 序 从 进程 到 线程 ， 再 到 调用 栈 当前 位 置 的 状态 。 每 一 步 都 允许 你 检查 不 同 的 进程 、 线 程 或 者 这 个 调用 
标 中 的 等 级 。 同 时 每 一 步 都 有 一 个 子 荣 单 ， 这 样 你 残 能 使 用 一 个 鼠标 手 努 设置 其 他 3 个 等 级 。 


PR ”你 的 Mac 系 统 可 能 是 自己 安装 的 ， 所 以 F~ 按 键 有 可 能 会 被 硬件 控制 函数 履 盖 ， 如 音量 控制 、 屏 幕 亮 暗 ， 或 者 被 系 
统 级 的 其 他 有 函数 中 断 。 检 查 系 统 偏好 设置 里 多 eyboatrd 面 板 中 Shottcuts 标 签 下 的 设置 ， 查 看 是 否 想 要 清除 这 些 快捷 键 ， 腾 出 来 供 
Xcode 使 用 。 按 住 fn 按键 可 在 这 两 种 使 用 方式 中 切换 功能 键 。 


我 们 对 passer_rating 这 个 程序 的 执行 很 感 兴趣 ， 现 在 一 行 行 地 看 着 它 执行 。 单 击 Step Over 按钮 (下划线 上 有 个 闭合 箭头 的 
按钮 ) ， 绿 色 的 箭头 就 会 跳 到 下 一 行 ， 你 会 发 现 变量 窗 格 中 发 生 了 一 些 变化 : completionComponent 的 值 变 为 了 NaN。 所 以 
现在 你 知道 : 这 个 值 在 第 一 次 计算 的 时 候 就 出 错 了 。 即 便 其 他 值 都 是 正确 的 ， 但 在 计算 过 程 中 任何 一 个 NaN 值 都 会 导致 最 后 的 
结果 变 为 NaN。 


下 一 行 调用 了 pinPassingComponent， 这 个 为数 会 修正 上 面 的 错误 吗 ” 单 击 Step In (下 划 线 上 有 个 向 下 指 的 箭头 ) » Si 
头 就 会 跳 转 到 pinPassingComponent 函 数 的 第 一 行 。 继 续 单 步 调试 ， 你 会 发 现 component 没 有 通过 if 语 句 里 面 的 任何 一 个 条 件 
(NaN 不 会 和 任何 值 进行 比较 ) 。 随 着 程序 的 执行 ， 箭 头 也 会 跟着 移动 到 相应 行 ， 跳 过 那些 没有 执行 到 的 代码 。 运 行 到 最 后 一 

个 return， 会 跳出 这 个 函数 的 执行 范围 ， 然 后 就 到 了 调用 这 个 函数 的 位 置 的 下 一 行 。 


pass-rating 这 个 程序 的 问题 非常 明显 : 从 来 没有 考虑 到 和 输入 值 为 0 的 情况 。 应 该 回 到 rating.c 这 个 函数 中 ， 做 出 相应 的 修 


但 是 如 果 继 续 妃 路 下 去 ， 你 会 友 现 一 些 问题 : 


1) 当 passer-rating 执 行 完毕 的 时 候 ， 调 试 区 域 消失 ， 你 无 法 再 观察 程序 的 输出 结果 。 你 不 得 不 回 到 工具 栏 ， 将 控制 合 显示 
出 来 ， 才 能 再 看 到 输出 结果 。 虽 然 只 有 一 点 及 烦 ， 但 终究 也 是 个 麻烦 。 


这 种 情况 在 程序 Hello World 中 更 糟 糙 ， 因 为 这 个 程序 没有 fgets() 调 用 。 程 序 将 会 迅速 退出 ， 同 时 在 你 还 没有 看 清 输 出 之 
前 ,调试 控制 台 束 会 被 关闭 。 


2) 如 果 passer-rating 仅 仅 有 一 点 不 同 ， 人 在 scanf( 接 受 输 入 之 前 不 显示 提示 行 ， 你 可 能 根本 不 会 看 到 调试 器 。 调 试 栏 会 显示 
在 Xcode 窗口 的 底部 ， 程 序 将 会 挂 起 ， 直 到 你 打开 调试 区 域 ， 执 行 一 些 输 入 操作 。Xcode 只 有 在 需要 打印 一 些 信息 的 时 候 才 会 显 
示 调 试 器 。 


3) Xcode 会 打开 调试 器 ， 用 于 显示 输出 内 容 ， 但 是 调试 导航 器 并 不 会 显示 出 来 ， 除 非 它 之 前 曾经 显示 过 ，。 
4) 但 是 ,在 一 个 断 点 处 暂停 ,的确 会 切换 到 调试 导航 器 。 
实际 情况 可 能 略 有 不 同 ， 但 是 不 可 能 每 个 用 户 都 对 这 些 窗口 的 显示 方式 感到 满意 。 


Xcode 提供 了 一 个 解决 方案 。 我 刚刚 描述 的 是 默认 配置 ， 你 可 以 蔡 换 这 些 默 认 配 置 。Xcode 能 让 你 在 特定 事件 发 生 的 时 候 为 
控件 设置 不 同 的 行为 。 
马 注意 ”如 果 这 不 是 你 第 一 次 使 用 Xcode， 那 么 你 很 有 可 能 已 经 更 履 了 Xcode 的 默认 行为 ， 所 以 就 看 不 到 我 说 的 这 些 情况 。 


但 是 这 理 是 一 样 的 。 


检查 系统 偏好 设置 中 的 Behaviors 面 板 ， 见 图 4.4。 可 用 的 事件 都 列 在 左 侧 ， 它 们 分 为 构建 、 测 试 、 运 行 、OpenGL 分 析 、 搜 
索 、 集 成 编译 ， 以 及 文件 解除 锁定 。 我 们 对 Running 一 Starts 事 件 感 兴趣 一 一 当 应 用 程序 在 调试 器 下 运行 的 时 候 发 生 的 事 。 


Starts 
v Generates new issues 
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v” Fails 
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图 4.4 Xcode 系统 偏好 设置 面板 内 的 Behaviors 面 板 能 让 你 决定 当 触 发 特定 事件 的 时 候 ，Xcode 会 做 出 什么 反应 


你 想 要 看 到 的 结果 是 : 无 论 何 时 ， 你 用 调试 模式 局 动 应 用 程序 的 时 候 都 要 显示 调试 区 域 。 默认 情 况 下 ， 当 程序 开始 运行 的 时 


候 ，Xcode 不 会 做 什么 特别 的 操作 : 项 目 窗口 已 经 配置 成 它 将 要 显示 的 样子 ， 你 不 会 得 到 任何 形式 的 通知 。 


ST 


1) 勾 选 Show/Hide...navigator 旁 边 的 复 


相反 ， 如 果 Xcode 会 显示 出 整个 调试 界面 而 不 用 等 待 断 点 或 者 输出 事件 ， 你 将 会 在 一 开始 束 得 到 整个 应 用 程序 的 状态 。 现 在 
告诉 你 为 了 做 到 这 点 应 该 如 何 更 改 配置 。 


框 。 

2) 确保 第 一 个 下 拉 菜 单 中 显示 的 是 Show 这 个 选项 。 

3) 在 第 二 个 下 拉 荣 单 中 选择 Debug Navigator 这 个 选项 。 
4) 勾 选 Show/Hide...debugger 条 目 旁 边 的 复 选 框 。 


5) 在 第 一 个 下 拉 荣 单 中 选择 Show 这 个 选项 ， 在 第 二 个 下 拉 茉 单 中 选择 Current Views 这 个 选项 。 你 也 可 以 强制 要 求 调试 器 


量 窗 格 和 控制 台 窗 格 中 的 任意 一 个 ， 或 者 两 个 都 显示 。 


行为 表单 中 的 Starts 这 一 行 的 旁边 有 一 个 选项 。 它 的 行为 与 Pauses 和 Generates out put 的 行为 匹配 ， 但 是 没有 什么 关系 ， 


如 果 改 变 了 Starts 的 行为 ， 你 不 用 做 任何 事 束 能 回 到 之 前 的 状态 。 


在 运行 结束 时 ， 除 非 应 用 程序 出 错 ， 否 则 我 想 要 隐藏 调试 区 域 ， 恢 复 项 目 导航 器 的 使 用 。 不 用 更 改 Completes 的 行为 ， 束 


用 它 的 默认 配置 即 可 。Show 导 航 器 Project Navigator， 如 果 没有 输出 ， 就 隐藏 调试 器 。 


9 注意 ”还 有 一 种 方法 可 以 查看 程序 的 调试 器 输出 。 导 航 区 域 最 后 一 个 带 有 说 话 气 泡 图 标的 选项 卡 能 打开 报告 导航 器 。 它 


包含 最 近 执 行 的 主要 操作 的 结果 ， 包 括 调 斌 会话 。 如 果 有 多 个 调试 会 话 ， 那 就 能 检查 并 在 它们 之 间 进 行 对 比 。 

让 我 们 尝试 下 更 改 是 否 有 效果 : 运行 passer-rating， 输 入 一 些 数 据 ， 得 到 结果 ， 然 后 按 ^D 终 止 程序 。 当 程序 开始 运行 的 时 
候 ， 调 试 区 域 和 调试 导航 出 现 ， 当 程序 结束 时 ， 项 目 导 航 器 重 现 ， 但 是 调试 区 域 也 还 在 ， 这 是 因为 passer-rating 在 控制 台中 有 
输出 。 这 说 明 配 置 更 改 成 功 。 


选项 下 


在 Behaviors 面 板 你 可 能 还 会 注意 到 一 个 很 吸引 人 的 选项 : Show tab named。 其 实 Xcode 是 一 个 项 目 浏览 器 ， 你 可 以 在 窗 
口中 添加 选项 卡 ， 这 些 选项 卡 每 个 都 能 为 你 的 工作 提供 不 同 的 视角 。 其 他 的 文本 编辑 器 可 以 在 每 个 选项 卡 中 打开 独立 的 文件 ， 但 
是 这 样 就 违背 了 Xcode 的 模型 。 这 个 选项 提供 的 功能 非常 强大 ， 但 是 另 一 方面 ， 也 非常 脆弱 。 


选择 File 一 New 一 New Tab (T) 切换 到 一 个 新 选项 卡 。 它 一 开始 显示 的 内 容 与 你 执行 这 个 命令 时 所 在 选项 卡 的 内 容 一 
致 。 兰 试 在 项 目 导 舰 器 中 选择 一 个 不 同 的 文件 ， 然 后 使 用 工具 栏 中 的 View 控 件 显示 出 右 侧 的 工具 区 (Utility area) 。 现 在 回 到 
之 前 的 选项 卡 : 它 不 仅 显 示 了 原先 的 文件 ， 而 且 还 天 闭 了 工具 区 。 想 想 另 一 种 用 法 。 你 可 能 拥有 3 种 用 于 不 同 用 途 的 选项 卡 。 

1) 一 种 是 直接 用 于 文件 编辑 : 选项 卡 中 没有 除了 编辑 器 和 项 目 导航 器 以 外 的 其 他 视图 。 


2) 一 种 用 于 Interface Builder， 它 占据 了 大 量 的 水 平 空间 : 导航 器 被 隐藏 ， 你 需要 使 用 跳 转 栏 进 行 浏览 。 帮 助 视图 
(Editor 控 件 中 间 的 按钮 ) 用 于 显示 视图 控制 器 对 应 的 代码 。 工 具 区 域 用 于 显示 组 件 库 。 

3) 还 有 一 种 用 于 调试 ， 它 将 会 显示 调试 导航 器 和 调试 区 域 。 

可 以 为 选项 卡 命名 : 双击 选项 卡 标签 (默认 情况 下 ， 选 项 卡 标签 名 是 当前 显示 文件 的 文件 名 ) 融 能 编辑 其 中 的 文字 ， 所 以 可 
以 分 别 将 这 几 种 用 途 的 选项 卡 命名 为 Edit、Interface Builder 和 Debugger。 

然后 打开 Behaviors 面 板 设 置 Edit 选 项 卡 ， 将 Completes 行 为 设置 为 Show tab named。 注 意 ， 不 要 选中 Show navigator 和 
Debug Navigator 行 为 ， 选 项 卡 已 经 设置 了 这 两 个 选项 。 这 么 做 的 效果 融 是 你 可 以 设置 窗口 的 外 观 和 功能 ， 这 些 功能 会 比 在 
Behaviors 面 板 中 设置 的 简单 选项 要 更 加 复杂 。 

到 现在 为 止 ， 一 切 顺 利 ， 但 还 不 够 稳定 。 针 对 每 个 选项 卡 单 独 设置 的 自由 并 不 会 阻止 你 更 改 那个 选项 卡 ， 它 也 会 失去 针对 不 


同文 件 类 型 做 出 不 同 响应 的 功能 。 如 果 你 有 任何 想 要 更 改 的 行为 (比如 说 显示 构建 事件 或 者 显示 调试 区 域 )， 一 个 简单 的 构建 并 
运行 操作 区 能 捧 毁 你 精心 制作 的 Interface Builder 选 项 卡 ， 除 非 将 系统 选项 卡 和 行为 针对 每 个 事件 都 更 改 为 单独 的 上 下 文 。 


43.2 ”解决 方法 
最 后 ， 让 我 们 开始 考虑 修正 passer_rating。 前 面 一 直 都 在 讲 行 为 和 选项 卡 的 问题 ， 现 在 开始 说 程序 的 修改 方法 显得 有 些 不 
合 时 宜 。 仪 需 将 下 面 这 段 代码 加 在 pass_rating 的 开头 : 


if (atts == 0) 
return 0.0; 


使 用 快捷 键 号 R 再 次 运行 程序 pass-rating。 在 命令 提示 符 后 输入 00000， 果 然 ， 你 会 看 到 结果 是 Rating=0.0。 按 下 ^D 组 合 
E, 调试 区 域 束 会 消失 ， 导 航 区 域 又 会 变 成 项 目 导 航 器 。 这 也 束 是 你 想 要 的 效果 。 


44 人 小结 
在 本 章 中 ， 你 使 用 Xcode 调试 器 接管 pass-rating， 追 踪 bug。 你 学 会 了 设置 断 点 、 单 步调 试 、 进 入 函数 、 跳 出 函数 、 随 着 
程序 的 执行 检查 或 者 更 改变 量 值 。 


你 也 学 习 了 一 毕 技 能 一 一 设置 行为 和 选项 卡 一 一 它 能 让 你 更 容易 控制 Xcode 目 行 更 改 窗 口 的 习惯 。 另 一 方面 ， 你 有 了 一 个 
重要 的 认识 : Xcode 不 仅仅 是 一 个 源 代码 编辑 器 ， 它 也 是 整个 开 友 工 作 流 的 浏览 器 。 








现在 ， 让 我 们 稍 事 休 息 ， 抛 开工 作 流 ， 初 步 认识 一 下 Xcode 工具 集 所 做 的 工作 。 


Slt ”编译 


在 继续 学 习 Xcode 之 前 ， 计 我们 先 回顾 一 下 计算 机 程序 的 生成 过 程 。 如 果 你 是 从 GNU Make 或 者 其 他 开 友 环境 转 到 Xcode 
的 读者 ， 应 该 会 很 熟悉 这 个 话题 。 请 稍微 忍耐 ， 我 会 重新 介绍 这 些 基础 知识 ， 这 样 每 个 读者 都 能 站 在 相同 的 起 跑 线 上 ， 对 程序 构 
建 过 程 有 同样 的 了 解 。 


程序 员 用 源 代码 控制 程序 的 行为 ， 源 代码 文件 包含 一 个 专用 且 通 常 经 过 加 密 的 符号 ， 用 于 辨别 人 类 的 产品 ， 在 一 定 程度 上 也 
是 为 了 人 们 能 够 可 读 。 即 便 是 涉及 暗示 这 种 非常 高 级 的 人 类 沟通 方式 ， 计 算 机 也 不 得 不 将 它 准 确 地 表达 出 来 。 比 如 说 ， 如 果 
passer-rating 这 个 工具 要 使 用 本 地 变量 yardageComp， 你 仅 需 关心 yardageComp 这 个 变量 名 始终 指向 特定 的 计算 结果 即 可 。 
然而 ,计算 机 的 CPU 在 运行 一 球 应 用 程序 的 过 程 中 ， 它 关心 的 是 为 yardageComp 这 个 变量 分 配 了 多 少 空间 ， 它 需要 被 解析 成 什 
么 格式 ， 为 了 使 用 yardageComp 需 要 保留 多 少 内 存 ， 用 过 之 后 要 释放 多 少 内 存 ， 内 存 应 当 对 齐 到 适当 的 地 址 边 

界 ，yardageComp 使 用 的 内 存 不 能 产生 内 存 使 用 冲突 的 问题 。 最 后 ， 当 要 发 生 数 据 存 取 操 作 的 时 候 ， 如 何 确定 yardageComp 
的 内 存 地 址 。 对 于 程序 中 每 个 有 名 称 的 值 都 需要 解决 这 些 问题 。 


5.1 编译 


平 运 的 是 ， 计 算 机 能 够 完成 这 些 工作 。 编 译 器 是 一 个 利用 源 代码 生成 对 应 机 器 指令 的 程序 。 考 虑 下 面 这 个 函数 ， 它 用 于 计算 
两 个 平均 值 ， 然 后 通过 结构 体 (struct) 将 结果 返回 调用 者 。 


void calculate stats (Results * results) 
f 


int n = 0, nScanned = 0; 
double sum X, sum Y; 
sum_X = sum Y = 0.0; 


do { 
double x, Vv 
nScanned = scanf("%lg %lg", &x, &y); 
if (nScanned == 2) { 


in; 
sum_X += X; 
sum_Y += y; 
} 
} while (nScanned == 2); 
Results lclResults = { .avg_X = sum_X/n 
#if CALCULATE AVG_Y 
, eavg_Y = sum Y/n 
#Hendif 
}; 


xresults = lclResults; 


CALCULATE AVG Ya@eESA0KA1, KNA TFAA ESR AYE. Bkitmaverage-y, X22; MSR 
译 成 24 行 汇编 代码 (用 于 处 理 器 执行 且 人 类 可 读 的 字 节 码 ) : 


_calculate_stats_100000e40: 


push rbp 
mov rbp, rsp 
push TLS 
push r14 
push TL3 
push rig 
push rbx 
sub rsp, 0x28 
mov ria. Tai 
lea rdi, qword [ds:0x100000f82] ; "%lg %lg" 
lea rsi, qword [ss:rbp-0x50+var_32] 
lea rdx, qword [ss:rbp-0x50+var_24] 
xor aly al 
call imp stubs_ scanf 
xOrps xmmi, xmml 
cmp eax, 0x2 
jne 0x100000ecb 
xor ebx, ebx 
lea rl5, qword [ds:0x100000f82] ; "%lg %lg" 
lea r12, qword [ss:rbp-0x50+var_32] 
lea r13, qword [ss:rbp-0x50+var_24] 
xorps xmm2, xmm2 
nop word [cs:rax+rax+0x0] 
addsd xmml, qword [ss:rbp-0x50+var_24] 


Og 为 了 谨慎 起 见 ， 这 是 由 Xcode 5 版 本 的 clang 编 译 器 将 优化 级 别 设置 为 -o3 时 生成 的 代码 。 
我 截取 了 前 25 行 ， 你 会 看 到 相应 的 输出 。 这 些 代码 并 不 是 很 易 懂 ， 除 非 你 天 天 和 汇编 打交道 。 


好 在 有 一 个 非常 实用 的 工具 Hopper Disassembler， 它 能 将 字 节 流转 换 成 C 风 格 的 遂 数 。 


function _calculate stats 100000e40 { 
r14 = rdi; 
rax = scanf("%lg %lg") ; 


xmml = 0x0; 

if (rax == 0x2) { 
rbx = 0x0; 
rl2 = «var_32; 
r13 = «var_24; 
xmm2 = 0x0; 
do { 


xmml = xmml + var_24; 
var_16 = xmml; 
xmm2 = xmm2 + var_32; 
var_8 = xmm2; 
rax = scanf("%lg %lg") ; 
xmm2 = var_8; 
xmml = var_16; 
rbx = tox: + 0x1; 
} while (rax == 0x2); 
} 
else { 
xmm2 = 0x0; 
} 
asm{ divsd xmmi, xmmO }; 
asm{ divsd xmm2, xmmO }; 
*r1l4 = xmm2; 
x* (rl4 + 0x8) = xmml; 
return rax; 


} 


虽然 变量 名 变 了 ， 但 还 是 能 看 出 个 大 概 。 观 察 反 编译 后 的 代码 ， 你 还 是 能 发 现 机 器 码 与 源 文件 之 间 的 区 别 : 这 段 经 过 反 编译 
的 代码 调用 了 两 次 scanf0 消 数 。 原 始 尔 数 读 取 并 计算 和 的 循环 由 scanf0 的 输入 是 否 是 两 个 值 来 控制 。 这 个 判断 在 循环 的 底部 、 
计算 输入 值 的 和 之 后 ， 所 以 原始 代码 通过 判断 输入 是 否 是 两 个 输入 ， 保 证 了 循环 中 间 和 的 计算 的 正确 性 。 编 译 器 通过 在 循环 开始 
之 前 多 调用 了 一 次 scanf(0) 消 数 ， 人 省 上 略 了 中 间 的 if 语 句 块 ， 科 化 了 循环 过 程 。 


现在 你 注意 到 了 很 重要 的 一 点 : 源 代码 是 你 想 要 程序 做 什么 的 表达 方式 ， 但 是 如 果 你 放任 不 管 ， 直 接 让 编译 器 处 理 ， 那 编译 
器 融会 重新 安排 〈 优 化 ) 代码 的 组 织 ， 用 于 满足 一 些 条 件 ， 通 常 是 为 了 提高 速度 ， 有 时 也 可 能 是 为 了 减少 程序 大 小 或 者 内 存 压 
力 。 它 唯一 的 责任 丈 是 保证 经 过 优化 的 代码 与 原始 代码 有 相同 的 执行 效果 。 一 行 行 地 调试 经 过 优化 的 代码 ， 你 会 友 现 程序 将 会 随 
机 地 在 代码 行 间 跳 转 。 


还 有 ， 让 我 们 将 CALCULATE AVG Y 这 个 安 的 值 设 置 为 0， 作 用 就 是 移 除 最 后 的 sum_Y。 那 么 内 部 循环 (而 scanf() 返 回 2) 


言 上 人 AR 


Masz]: 

do { 
var_16 = xmml; 
var_8 = var_32; 
rax = scanf("%lg %lg"); 
xmml = var_16; 
xmml = xmml + var 8; 
rbx = rbx + 0x1; 

} while (rax == 0x2); 


如 果 仔 细 观 察 这 段 代 码 ， 你 会 友 现 Sum_Y 不 见 了 。 编 译 器 知道 ， 这 个 变量 用 于 计算 y 值 的 和 ， 别 的 地 方 没有 用 到 这 个 变量 。 
但 是 程序 中 根本 束 没 有 计算 这 个 和 和， 所 以 编译 器 会 将 sum_Y 完 全 移 除 。 如 果 在 调试 器 中 跟踪 这 段 代码 ， 将 不 会 看 到 sum_Y 的 
值 ， 因 为 它 没 有 值 。 


平 运 的 是 ， 你 可 以 关闭 所 有 的 优化 ， 之 后 反 编 译 的 循环 残 和 你 写 的 源 代 码 很 类 似 了 ， 包 括 没有 用 到 的 Sum_Y 也 会 出 现 。 


function _calculate stats 100000e70 { 


xmm0 = 0x0; 
var_56 = rdi; 
var_52 = 0x0; 
var_48 = 0x0; 
var_32 = xmm0; 
var_40 = xmm0; 
do { 
rax = scanf("%lg %lg"); 
var_48 = rax; 
if (var_48 == 0x2) { 
var_52 = var_52 + 0x1; 
var_40 = var_40 + var_24; 
var_32 = var_32 + var_16; 
} 
} while (var_48 == 0x2); 
asm{ divsd xmml, xmm2 }; 


Var 0 = var_40; 

var_8 = 0x0; 

rax = var_56; 

rax = var_0; 

*(rax + 0x8) = var_8; 
return rax; 


Xcode 调试 构建 时 使 用 设置 (-00) 。 


当 想 到 编译 器 从 源 代码 中 生成 可 执行 的 机 器 指令 必须 要 做 的 任务 时 ， 首 先进 入 脑海 的 应 该 是 机 器 指令 的 选择 : 浮 点 数 相 加 操 
作 转 化 为 addsd 指 令 或 者 用 coml、je 和 和 mp 实现 的 do/while 循 环 。 这 个 最 简单 的 例子 无 法 展现 出 编译 过 程 中 的 全 狐 。 


编译 过 程 中 另外 一 项 非常 重要 的 工作 丈 是 符号 (symbol) 省 理 。 每 一 个 C 销 数 和 变量 都 要 按照 内 存 位 置 、 地 址 和 长 度 等 要 
求 转换 成 机 器 码 。 编 译 器 必须 严格 记录 每 一 个 符号 、 地 址 的 赋值 一 一 或 者 最 起 码 也 要 有 一 种 获得 地 址 的 方法 一 一 确保 没有 两 个 
符号 指向 了 同一 块 内 存 地 址 。 下 面 是 没有 经 过 优化 的 汇编 代码 的 开头 部 分 : 





push rbp 

mov rbp, rsp 

sub rsp, 0x40 

xorps xImm0, xmm0O 

mov qword [ss:rbp-0x40+var_56], rdi 

mov dword [ss:rbp-0x40+var_52], 0x0 

mov adword [ss:rbp-0x40+var_48], 0x0 

movsd qword [ss:rbp-0x40+var_32], xmm0 
movsd qword [ss:rbp-0x40+var_40], xmm0 


通过 分 析 calculate_stats， 友 现 编译 器 在 RAM 中 为 本 地 变量 预 留 了 一 些 内 存 空间 ， 并 用 通用 寄存 器 rbpi 记 录 这 一 块 内 存 结尾 
的 地 址 。8 字 书 的 浮 点 数 x (var 40) 指向 了 内 存 区 块 40 字 节 的 位 置 。y 指 同 了 x 之 前 8 字 节 的 位 置 。 编 译 器 会 保证 这 块 内 存 不 会 用 
于 其 他 用 途 。 


在 优化 的 版 本 中 ， 和 的 值 甚至 不 会 存在 内 存 中 ， 而 是 保存 在 处 理 器 的 浮 点 寄存 器 中 ， 从 这 里 读 取 和 的 值 。 比 如 ， 寄 存 器 
xmm1 保 存 了 sum _x 的 值 。 与 之 前 一 样 ， 编 译 器 会 保证 每 块 数据 都 有 保存 它 的 位 置 ， 而 且 不 会 有 两 块 存储 区 域 友 生 使 用 冲突 。 


在 Xcode 项 目 中 ， 需 要 编译 的 文件 都 能 在 Target 编 辑 器 中 找到 : 打开 窗口 左 侧 的 Navigator 区 域 ， 选 择 第 一 个 选项 卡 显示 出 
项 目 导 航 器 。 顶 部 的 条 目 代 表 了 项 目 和 它 所 有 的 target。 从 TARGETS 列 表 中 选择 产品 的 名 称 。 


构建 target 时 需要 编译 的 文件 都 列 在 Build Phases 选 项 卡 下 Compile Sources 构 建 阶段 的 配置 中 ， 见 图 5.1。 
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图 5.1 在 项 目 导 航 器 中 选择 项 目 图 标 ， 显 示 出 项 目 及 其 包含 的 tatget 的 编辑 器 。Tatget 编 辑 器 中 的 Build Phases 选 项 卡 是 一 个 显示 构 

建 target 各 个 阶段 的 表格 。 单 击 任意 phase 前 面 的 提示 三 角 ， 会 显示 出 这 个 阶段 需要 的 文件 。 即 便 是 最 简单 的 构建 过 程 ， 也 会 有 一 

个 Compile Sources 阶 段 (上 ) ， 其 中 包含 所 有 需要 转换 为 对 象 文件 的 文件 。Link Binary With Libraries 阶 段 (下) 用 于 指定 构建 完整 
“ 品 需 要 的 预 编译 系统 和 私有 代码 


call imp___stubs__scanf 


这 行 汇编 代码 对 应 的 是 函数 scanf(0 的 调用 。Imp---stubs--scanf 是 什么 类 型 的 符号 ”在 整个 汇编 代码 中 查看 scanf(0 也 友 现 
不 了 太 多 线索 : 我 们 会 找到 名 为 imp la symbol ptr scanf 的 位 置 ， 它 被 初始 化 为 一 个 64 位 数 。 编 译 后 的 应 用 程序 不 包含 任何 关 
于 scanf() 的 代码 或 者 内 存 分 配 。 


因为 scanf0) 是 标准 C 程 序 库 的 组 件 ， 所 以 你 不 想 上 自己 定义 它 ， 而 希望 使 用 来 自 程序 库 中 的 代码 。 但 是 编译 器 每 次 只 能 处 理 一 
个 .< 或者.m 文 件 ， 没 有 任何 方法 能 够 直接 获得 scanf() 的 起 始 地 址 。 所 以 编译 器 不 得 不 将 这 个 位 置 留 空 ， 之 后 再 将 这 个 位 置 填 上 
J 正确 的 值 。 因 此 ， 在 构建 程序 的 过 程 中 ， 必 须 还 有 一 个 额外 的 过 程 来 填 满 这 种 空 日 。 


编译 阶段 的 产物 是 对 象 文件 (object file) ， 它 包含 由 源 代码 生成 的 机 器 码 ， 还 包含 那个 文件 定义 了 什么 符号 ， 以 及 还 有 什 
么 符号 需要 定义 的 详细 信息 的 文件 来 。Objective-C 源 文件 的 后 缀 是 .m， 对 象 文件 名 与 之 相同 ， 但 是 后 缀 由 .m 更 改 为 .0 (对 
R) 。 库 文件 是 单独 的 文件 ， 它 集合 了 单 用 的 符号 和 定义 。 在 这 个 简单 的 例子 中 ， 库 文件 名 以 lib 开 头 ， 以 .a 结 尾 。 


在 编译 后 的 代码 中 反 辐 填 苑 未 解析 的 地 址 的 行为 被 称 作 链 接 编 辑 (linkage editing) ， 或 者 简称 为 链接 (linking) 。 你 给 
链接 器 提供 了 一 系列 对 象 文 件 和 库 文件 ， 希 望 链接 器 能 为 应 用 程序 中 使 用 的 每 个 未 解析 的 符号 都 找到 对 应 的 定义 。 之 前 每 个 留 为 
空 日 的 地 址 都 会 被 填 上 相应 的 地 址 。 结 果 束 是 执行 程序 中 会 包含 应 用 程序 用 到 的 所 有 代码 ， 见 图 5.2。 
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图 5.2 ”这 是 将 源 代 码 转 化 为 可 执行 二 进 制 程序 的 简化 过 程 。 你 在 Linfgm 中 提供 了 源 代 码 〈 左 上 ) ; 编译 这 个 文件 会 产生 相应 的 
对 象 文件 Lintfgeo， 它 包含 了 经 过 转化 后 的 代码 ， 还 有 calculate.c 中 未 定义 的 无 法 解析 的 函数 引用 。 其 他 的 库 文件 〈 比 如 说 libma.a 和 
libc.a) 包含 这 些 函 数 的 机 器 码 。 链 接 器 的 作用 就 是 合并 你 的 代码 和 生成 完整 的 可 执行 程序 所 需 的 其 他 函数 (下 ) 


这 个 过 程 对 应 应 用 程序 target 列 表 中 的 Link Binary With Libraries 构 建 阶 段 。 这 个 阶段 列 出 应 用 程序 将 要 链接 的 全 部 库 文 件 
和 框架 。 


图 注意 ”元 锐 的 读者 可 能 已 经 发 现 图 51 中 的 链接 阶段 没有 包含 任何 库 文件 。 这 有 两 个 原因 : 一 是 大 多 数 C 编 译 器 默认 情况 
下 都 会 将 标准 C 库 文件 链接 到 程序 中 ， 二 是 因为 编译 器 clang 实 现 了 C 家 族 语言 的 模 决 化 扩展 (modules extension) ， 每 当 程序 中 使 


用 了 某 个 头 文 件 ， 它 就 会 自动 将 对 应 的 库 文件 链接 到 程序 中 。 详 情 请 见 5.5.2 节 。 


5.2 ”动态 载 入 





一 般 来 说 ， 动 态 载 入 这 个 阶段 比 之 前 的 阶段 都 要 复杂 。 标 准 消 数 ， 比 如 scanf0)， 可 能 会 被 系统 中 很 多 进程 一 一 可 能 有 上 百 
同时 用 到 。 将 实现 scanf0 的 机 器 码 复制 到 每 一 个 应 用 程序 中 ， 会 渤 无 意义 地 浪费 磁盘 空间 。 解 决 方案 束 是 动态 载 入 


a 





(dynamic loading) 。 即 使 在 可 执行 文件 中 ， 应 用 程序 也 会 把 用 到 的 通用 库 阔 数 的 地 址 留 为 空 ， 仪 提供 部 分 可 执行 代码 以 及 需 
要 解析 的 符号 和 对 应 的 系统 库 的 上 目录。 之后， 操作 系统 会 在 整个 系统 范围 内 共享 的 库 文 件 中 获取 那 学 未 包含 的 代码 ， 然 后 在 程序 
运行 的 时 候 ， 将 它们 链接 到 可 执行 程序 当中 。 


动态 载 入 不 仅 节 约 了 磁盘 空间 ， 而 且 节 省 了 RAM 和 应 用 程序 的 执行 时 间 。 当 一 个 动态 库 一 动态 链接 的 对 象 文 件 的 集合 ， 
其 名 称 以 lib 开 头 ， 以 .dylib 结 尾 一 一 被 载 入 物理 内 存 时 ， 每 个 需要 使 用 这 个 动态 库 的 应 用 程序 都 能 看 到 这 段 内 存 。 之 后 ， 表 使 用 
这 个 动态 库 的 应 用 程序 融会 节约 相应 的 内 存 和 载 入 时 间 。 


DEE 和 其 他 现代 操作 系统 一 样 ，iOS 操 作 系 统 也 会 依赖 动态 链接 库 用 于 共享 服务 。 在 iDOS 8 中 ，App 也 可 以 使 用 动态 
库 ， 按 照 框 架 的 形式 使 用 ( 见 第 17 章 ) 。 框 架 技 术 十 分 有 用 ， 因 为 它 将 库 代 码 和 用 到 的 资源 放 到 了 独立 的 包 中 ， 开 发 者 可 以 直接 
将 它们 链接 到 应 用 程序 当中 。 继 承 于 框架 的 应 用 程序 扩展 ， 克 许 iDOS App 为 其 他 App 提 供 服务 。 


如 果 动 态 库 直到 运行 的 时 候 才 与 应 用 程序 的 可 执行 代码 链接 在 一 起 ， 为 什么 还 要 把 它们 算 到 构建 过 程 中 的 链接 阶段 ? 这 有 两 
个 原因 。 首 先 链接 器 能 够 确定 应 用 程序 中 无 法 解析 的 符号 都 定义 在 哪里 ， 并 且 如 果 出 现 拼 写 错误 或 者 使 用 了 不 存在 的 遂 数 ， 那 么 
已 能 友 出 一 个 错误 信息 ; 其 次 ， 动 态 链 接 代码 中 的 链接 构建 表 不 仪 指定 了 它 需 要 解析 的 符号 ， 还 包含 了 所 需 的 定义 应 该 在 哪个 库 
文件 中 寻找 。 借 助 文件 说 明 ， 动 态 载 入 器 不 需要 在 全 部 系统 的 库 文件 中 搜寻 每 个 符号 ， 同 时 ， 应 用 程序 可 以 指定 未 包含 在 通用 搜 
寻 路 径 中 的 私有 动态 库 。 


5.3 Xcode 和 Clang 


传统 的 编译 器 束 像 之 前 描述 的 那样 ， 它 是 一 个 命令 行 工 具 ， 读 取 源 代码 ， 将 其 转化 为 目标 代码 ， 然 后 停止 运行 。 这 就 是 自由 
软件 基金 会 (Free Software Foundation) 广泛 使 用 的 gcc 的 功能 ， 从 Xcode 4 开始 ，Xcode 也 支持 gcc。 


然而 ，gcc 已 经 变 得 难以 忍受 。gcc... 太 成 就 了 。Apple 需 要 扩展 C 和 Objective-C 的 特性 ， 这 样 才能 更 好 地 编写 简单 可 依赖 
的 Cocoa 程 序 。Apple 已 经 对 gcc 做 了 很 多 扩展 ， 也 发 布 了 它 的 版 本 。 但 是 ， 针 对 一 个 拥有 众多 利益 相关 者 和 依赖 关系 的 项 目 做 
重大 的 代码 修改 是 一 件 非常 麻烦 的 事情 ， 并 且 Apple 需 要 的 部 分 功能 无 法 基于 gcc 代 码 库 实现 。 


而 且 ，gcc 的 发 布 遵循 GNU General Public License， 这 个 协议 规定 所 有 链接 遵循 GPL 代 码 的 项 目 都 要 开源 。 这 人 么 做 没 错 ， 
但 是 Apple 的 想法 不 一 样 : 它 想 将 编译 器 技术 集成 到 自己 的 软件 之 中 ， 并 不 打算 友 布 源 代码 。 


Apple 的 解决 方案 是 以 链接 库 的 形式 使 用 另外 一 个 新 的 开源 编译 器 引 苟 llvm， 它 在 Xcode 3.2 版 本 中 第 一 次 使 用 。llvm 的 主 
要 产品 是 C 语 言 家 族 的 编译 器 clang， 但 它 还 有 很 多 其 他 产品 。 


. Xcode 文本 编辑 器 链接 了 llvm， 它 能 让 你 在 代码 从 解析 阶段 到 最 终 的 产品 的 过 程 中 持续 得 到 信息 。 打 开 偏 好 窗口 
(Xcode—Preferenceshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/... d6comma) ， 然 后 设置 Issues:Show live issues， 这 样 就 能 在 


代码 的 输入 过 程 中 看 到 警告 和 错误 。 


` llvm 库 被 链接 到 了 Xcode 的 调试 引擎 lldb 中 。1ldb 允 许 你 在 命令 行 中 输入 源 代码 语句 ， 它 会 编译 它们 ， 然 后 将 编译 后 的 代码 
插入 调试 的 进程 中 (与 被 调试 的 代码 茹 容 ， 因 为 它们 使 用 的 是 同样 的 编译 器 ) 。 


‘OpenGL (OS X 的 图 形 工 具 ， 它 利用 图 形 芯 片 的 计算 能 力 执 行 大 规模 的 并 行 计算 ) 依赖 客户 端 中 程序 类 C 的 源 代码 。 但 是 
GPU 的 种 类 不 同 。OS 使 用 llvm 将 源 代 码 转 化 为 供 系 统 GPU 使 用 的 二 进 制 文件 。 


- 供应 商 桥接 了 Cocoa 和 “托管 ”或 者 可 编译 的 语言 ， 将 lvm 库 链接 到 它们 自己 的 编译 器 中 ， 就 能 将 运行 速度 较 慢 的 代码 转 
化 为 CPU 原生 代码 。 


使 用 llvm 让 Apple 的 开发 系统 有 了 巨大 的 飞跃 。 之 前 ，Objective-C 语 言 几 十 年 间 仅 有 微小 的 变化 ， 但 是 新 的 使 用 方法 和 新 
的 代码 转换 方式 让 它 越 来 越 没 效率 ， 也 越 来 越 不 如 以 前 安全 。llvm 人 允许 clang 深 入 开发 者 的 代码 之 中 ， 实 现代 码 诊断 和 生成 。 


5.3.1 本 地 分 析 


前 几 代 编译 器 的 观点 是 将 源 代码 限定 在 特定 的 学 围 内 ， 最 好 是 单行 ， 最 好 不 要 有 太 长 的 冰 数 。 它 们 会 告诉 你 哪 一 行 产 生 了 销 
误 ; clang 可 以 捐 明 token。 它 会 告诉 你 无 法 识别 你 使 用 的 某 个 符号 。 你 也 可 以 让 它 指定 特定 的 编码 规 学 ， 帮 你 做 双重 检查 。 
clang 能 够 纠正 拼写 错误 ， 也 能 纠正 它 认为 上 下 文中 有 问题 的 表达 式 。 


clang 可 以 知道 代码 中 约定 俗 成 的 规定 和 其 他 限制 。Cocoa 编 程 中 一 种 剃 见 的 手法 就 是 万 法 市 有 一 个 指针 参数 ， 这 个 指针 指 
癌 NSError 对 象 。 如 果 产 生 了 一 个 错误 ， 这 个 方法 融会 得 到 一 个 指向 这 个 错误 对 象 的 3 引用， 然后 将 这 个 引用 传递 给 调用 者 。 不 
过 ， 这 种 方法 总 是 会 接受 一 个 NULL 指 针 ， 以 防 调用 者 想 要 忽略 这 个 错误 的 详细 信息 。 


考虑 下 面 这 个 基础 (Foundation) 命令 行程 序 ， 它 实现 了 市 有 3 个 方法 的 简单 类 。 
#import <Foundation/Foundation.h> 


static NSString * const MyErrDomain = @"MyErrDomain"; 


@interface MyClass : NSObject 

(void) doSomething; 

(BOOL) methodWithErrorRef: (NSError **) error; 
@property(nonatomic, assign) BOOL somethingWrong; 
@end 


@implementation MyClass 


(instancetype) init 
{ 
self = [super init]; 
if (self) { 
_somethingWrong = NO; 
} 


return self; 


- (void) doSomething { self.somethingWrong = YES; } 


- (BOOL) methodWithErrorRef: (NSError **) error 
{ 
NSError * justiInCase = 
[NSError errorWithDomain: MyErrDomain 
code: -1 userinfo: nil]; 
xerror = justInCase; // Line 29 


[self doSomething] ; 

if (self.somethingWrong) 
return NO; 

else 
return YES; 


} 
@end 


int main(int argc, const char * argv[]) 
{ 


@autoreleasepool { 


MyClass * object = [[MyClass alloc] init]; 
NSError * error; 
if ({object methodWithErrorRef: &error]) { 
NSLog (@"Method on %@ succeeded", object); 
} 


else | 
NSLog (@"Method on %@ failed", object); 


return 0; 


Og 留意 methodWithErrorRef 这 个 方法 : 这 个 方法 在 错误 发 生 之 前 ， 先 传 入 了 一 个 通用 错误 。 接 受 NSEtrror+ 引 用 的 方法 
允许 这 么 做 。 调 用 者 一 定 不 要 尝试 着 通过 检查 NSError 返 回 值 来 决定 是 否 产 生 了 错误 。 这 个 值 可 能 存在 ， 但 是 并 不 一 定 准确 。 只 
有 方法 的 返回 值 才能 告诉 你 是 否 真 的 产生 了 错误 。 


MyClass 非 常 简单 ， 仪 有 一 个 普通 函数 ， 它 接受 一 个 指向 NSError* 指 针 的 指针 。 用 clang 仔 细 查 看 下 这 段 代码 : 选择 
Product 一 Analyze (?%B) 。 用 不 了 多 久 ， 事 件 导 航 器 会 出 现 带 有 蓝 色 标记 的 条 目 ， 日 志 信息 中 会 显示 如 下 : 


main.m:29:9: warning: Potential null dereference. 
According to coding standards in 'Creating and 
Returning NSError Objects' the parameter may be null 
xerror = justInCase; 
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这 是 一 个 很 好 的 功能 ，Apple 教 给 clang 一 条 标准 编码 标准 ， 当 你 违反 了 这 条 标准 的 时 候 ，clang 丈 会 友 出 警告 。 当 友 生 错 误 
的 时 候 ， 它 甚至 能 确定 字符 的 位 置 (= 赋值 操作 待 ) 。 编 辑 器 会 在 这 个 位 置 显 示 一 个 红色 的 插入 字符 。 


5.3.2 BRAT 


XNR SRA. TemainedayPialAymethodWithErrorRefAyatte, ANULLÆ Z &error, BAVATAM. 
编码 惯例 (coding-convention) 错误 标志 为 一 个 “次 辑 错 误 ”。 单 击 事件 导航 器 中 的 提示 三 角 ， 仔 细 看 下 其 中 的 细节 : 
1) 在 main(0 中 ，Passing null pointer value via 1st parameter ‘error’ , 


2) 调用 ‘methodWithErrorRef' , 


3) 在 methodWithErrorRef 中 : Entered call from ‘main’ , 


4) Dereference of null pointer (loaded from variable ‘error’ ) 。 


原始 标记 针对 违反 编码 惯例 。 这 是 一 个 由 实际 (actual) 执行 路 径 引 起 的 实际 编程 错误 的 警告 ，clang 跨 越 两 个 尔 数 追踪 到 


了 这 个 警告 ， 见 图 5.3。 


HX 


全 注意 在 横幅 (banner) 和 事件 导航 器 之 间 ， 很 难看 到 错误 、 警 告 以 及 分 析 信 息 的 完 


的 空间 ， 即 便 使 用 最 小 的 字体 ， 事 件 条 目 也 只 能 显示 信息 的 前 几 个 字 。 可 以 在 设置 中 解决 这 个 问题 : 打开 Ptefetences 窗 口中 的 


General 面板 ， 将 “Issue Navigator Detail: ”设置 为 Up to Ten Lines。 这 样 就 能 有 大 量 空间 显示 信息 文字 。 


int main(int argc, const char * argv[)) 


@autoreleasepool { 
Cr ( object meg dWithErrorRef: © 1. Passing null pointer value via 1st parameter ‘error’ O 
E: (esMethod_on a_succEeded", object E 2. Calling 'methodWithErrorRef:" 
} 


else { 
NSLog(@"Method on %@ failed", object); 
} 


} 


return @; 


3. Entered call from ‘main’ 


5 =— (BOOL) methodWithErrorRef: (NSError **) error 


“SeNSError ' x justInCase = 
[NSError errorWithDomain: MyErrDoma ir 


AAA code: -1 userinfo: nil); 
*error = justinCase; D 4. Dereference of null pointer (loaded from variable 'error) © 
Dereference of null pointer (loaded from variable ‘error’ 


[self doSomethi ngl; 

if ([self somethingWentWrong] ) 
return NO; 

else 
return YES: 





图 5.3 ”很 早 之 前 ，clang 就 可 以 对 程序 实际 运行 引起 的 程序 错误 发 出 人 警告， 即使 这 个 错误 发 生 在 两 个 函数 之 间 。 展 开 逻 辑 错 误 的 


详细 信息 ， 可 以 看 到 阐述 导致 这 个 错误 的 实际 路 径 的 箭头 


5.3.3 ”索引 
项 目 索引 是 Xcode 1 中 就 有 的 功能 ， 而 且 现 在 仍然 是 Xcode 的 核心 功能 。Xcode 会 在 后 台 检 查 你 的 代码 库 、 你 所 使 用 的 所 有 


系统 文件 ， 以 收集 每 个 符号 的 类 型 以 及 定义 位 置 。 这 些 信 息 有 很 多 


编辑 器 可 以 为 屏幕 中 显示 的 每 一 个 结构 分 配 唯一 的 颜色 。 





+ 按 住 command 键 的 同时 单 击 符号 ， 就 会 直接 跳 到 对 应 的 声明 。 这 个 手 


击 “fileExistsAtPath:isDirectory: ” 的 第 一 部 分 ， 会 选中 整个 方法 名 而 不 仅仅 是 “fleExistsAtPath: 


. 可 以 单 击 一 个 符号 ， 然 后 在 它 旁 边 的 指示 器 中 执行 命令 Edit All in Scope。 修 改 一 个 符号 将 会 更 改 引 用 相同 对 象 所 有 其 他 实 


Vv 


二 个 选项 卡 ) 可 以 显示 一 个 目录 ， 里 面 是 项 目 中 定义 的 所 有 符号 ， 单 击 其 中 的 符号 就 会 跳 到 


- 符号 导航 器 (导航 器 区 域 的 第 


对 应 的 符号 定义 。 这 种 功能 对 (@property 指 令 也 有 用 : 它们 一 般 会 创建 设置 和 检查 属性 的 隐藏 方法 。 符 号 导航 器 会 显示 隐 式 方 
> 


和 程序 中 的 文档 注释 转变 为 在 线 帮 助 文 档 的 新 机 制 ， 可 以 选择 在 具有 相同 名 称 的 方法 中 显示 哪个 文档 。 
. 重 构 功能 可 以 应 用 到 复杂 符号 的 所 有 实例 上 (比如 多 部 分 方法 名 ) ， 没 有 文本 或 者 模式 搜索 的 限制 。 


:Assistant 编辑 器 能 设置 成 显示 主编 辑 器 中 被 选中 的 方法 的 全 部 调用 者 和 被 调用 者 。 使 用 这 个 小 技巧 可 以 用 新 方法 替换 过 时 
的 方法 ， 仅 需 遍 历 调用 者 列表 ， 替 换 为 新 方法 ， 直 到 调用 者 列表 为 空 为 止 。 


在 引入 llvm 之 前 ，Xcode 不 得 不 使 用 它 目 己 的 解析 器 ， 它 想 要 与 gcc 编 译 器 的 行为 保持 一 致 可 能 有 些 困难 。 使 用 运行 缓慢 的 
索引 分 析 器 (也 可 能 是 计算 机 太 慢 ) ， 经 常会 重新 索引 ， 从 而 打 断 你 的 工作 流程 。 为 一 个 大 项 目 创建 泰 引 会 伦 费 很 长 的 时 间 (R 
然 你 可 以 在 建立 泰 引 的 过 程 中 继续 工作 ) ， 初 次 泰 引 创建 完成 之 后 ， 玖 不 会 青 注 意 到 索引 过 程 了 。llvm 保 证 了 索引 器 和 clang 能 
在 同样 复杂 的 代码 模型 下 工作 。 


5.4 Swift 


Objective-C 和 C 语 言 家族 使 用 非常 方便 ， 但 它们 还 是 有 一 些 缺点 。 
Clang 已 经 尽 可 能 地 让 Apple 平 台 的 编程 尽 可 能 遍 效 且 可 信赖 一 如 果 你 能 容忍 以 下 缺点 。 


:Objective-C 是 C 的 超 集 。 任 何 合法 的 标准 C 语 言 程序 都 是 一 个 合法 的 Objective-C 程 序 (这 与 C 和 C++ 的 关系 不 一 样 ) o A 
C 语 言 的 目的 是 为 了 提供 一 种 方便 、 可 移植 的 方法 来 编写 针对 微型 计算 机 操作 系统 的 汇编 代码 。 汇 编 代 码 拥 有 对 运行 它 的 机 器 的 
控制 权 如 果 开 发 者 想 要 声明 10 字 节 大 小 的 数组 ， 然 后 来 回 遍 历 它 所 占 的 内 存 ， 这 是 开发 者 最 了 解 的 内 容 。 它 不 仅仅 对 应 用 程 
序 开发 者 来 说 引入 了 灾难 ， 对 所 有 人 来 说 都 是 个 问题 。 但 避免 了 这 个 问题 的 语言 并 不 是 C 语 言 。 





- 针对 操作 系统 最 小 集 编程 的 工具 来 说 ， 无 法 假设 或 者 喜欢 任何 一 种 管理 系统 资源 的 方法 。 尤 其 是 ，C 没 有 也 不 能 关心 动态 
内 存 管理 。 标 准 C 库 有 函数 提供 了 类 似 malloc0 和 ftee0 这样 的 例 程 来 声明 内 存 块 ， 但 是 它们 仅仅 是 函数 。C 语 言 本 身 不 知道 它们 做 了 
么 特别 的 工作 。C 并 不 是 一 个 落实 了 内 存 管 理 原 则 的 语言 。 


- 在 Objective- C 中 ， 方 法 分 配 - 一 一 对 于 一 个 对 象 选择 合 





总 是 假设 任何 方法 可 能 有 独立 的 实现 ， 无 
论 这 个 实现 是 通过 子 类 的 重 写 还 是 独立 于 类 外 的 平行 函数 。 这 种 程序 的 灵活 性 被 称 为 动态 类 型 (duck-typing) ， 这 种 类 型 非常 强 
大 但 是 实际 应 用 中 很 少 使 用 。 聪 明 的 编译 器 可 能 将 独立 实现 的 方法 转化 成 直接 寻 址 的 函数 ， 但 是 整个 C 家 族 的 编译 器 对 整个 程序 
的 了 解 相 当 少 。Jave 和 C++ 让 〈 或 者 说 强制 ) 程序 员 提 供 相 关 信 息 ， 但 是 C 语 言 无 法 做 到 这 点 


+ 代码 生成 和 编程 技术 从 20 世 纪 70 年 代 末 期 就 有 了 长 足 的 进步 。 我 们 了 解 的 越 来 越 多 ， 同 时 我 们 的 计算 能 力也 越 来 越 让 这 些 
技术 变 得 切实 可 行 : 泛 型 函数 和 数据 类 型 ;编译 器 可 以 在 完全 不 同 的 实现 和 资源 策略 中 自由 选择 ; 在 函数 间 传 递 可 执行 代码 一 一 
类 似 和 参数 或 者 函数 返回 值 一 一 就 像 传 递 其 他 数据 一 样 自由 ; 控制 结构 (比如 switch) 不 仅 可 以 测试 两 个 以 上 字 节 模型 是 否 相 等 ， 
等 等 。 自 从 发 明了 C++ 和 Objective-C 这 两 门 语言 ， 它 们 在 几 十 年 间 已 经 有 了 长 足 进 





尤其 是 llvm 可 以 使 用 后 ，Apple 成 功 地 将 部 分 想法 集成 到 一 种 语言 中 ， 这 种 语言 还 与 C 语 言 兼容 : 跨国 数 的 代码 分 析 ~ 特 
定 环境 下 ) ; KR; 属性 和 自动 引用 计数 (Automatic Reference Counting) 。 但 是 这 门 语言 与 C 还 是 有 些 相似 ， 在 分 析 、 
全 性 和 表达 性 方面 有 些 限 制 。 


最 明显 的 解决 方案 融 是 创建 一 门 语言 ， 透 明 、 安 全 并 且 表 达 力 强 ， 还 能 表达 旧式 的 Objective-C 数 据 结构 和 设计 模式 。 这 并 


不 是 一 个 轻松 的 任务 ， 在 WWDC 2014，Apple 公 布 了 它 的 解决 方案 : Swift 编程 语言 。 


本 书 不 会 深入 介绍 Swift 访 语言 ， 本 书 之 前 的 版 本 避免 在 抛 开 对 Xcode 工作 流 的 影响 下 讨论 一 门 语言 及 其 相关 的 技术 。 但 
是 Swift 实 在 太 特 别 了 ， 我 想 要 简单 介绍 下 Swift 的 用 途 ， 尤 其 是 使 用 Objective-C 这 门 语言 难以 实现 的 一 些 功 能 。 


` 泛 型 函数 ， 它 能 表达 纯粹 的 算法 而 不 用 指定 这 个 算法 处 理 的 数据 类 型 。 
: 类 型 推断 ， 很 多 情况 下 ，Swift 不 需要 显 式 类 型 声明 就 能 使 用 严格 的 数据 类 型 。 
: 闭 包 ， 它 是 一 个 可 执行 的 代码 块 ， 当 程序 执行 的 时 候 ， 能 够 传递 、 调 用 黄 至 创建 代码 (函数 只 是 闭 包 的 一 个 特例 ) 。 


. cuttying， 它 是 一 种 通过 修改 部 分 参数 来 创建 一 个 新 函数 ， 由 此 特殊 化 原始 函数 的 技术 。 新 函数 接受 其 他 参数 (通常 只 有 


在 第 3 章 中 你 已 经 注意 到 了 : passer rating 的 组 件 固 定 在 一 个 不 小 于 0.0 且 不 大 于 2.375 的 时 间 间 隔 内 。 它 使 用 
pinPassingComponent0 国 数 保证 了 精确 的 间隔 。 在 Swift 中 ， 实 现 类 似 的 功能 可 能 会 如 下 所 示 : 


/ 文大 炎炎 炎炎 炎炎 炎炎 炎炎 火炎 炎炎 炎炎 炎炎 Generic pinner: kkk k k k k k kk k k k k k k k k k | 
/* Given a value, make it no less than a lower bound, nor more 
than an upper. The three values need only be of the same type, 


and that type must conform to the Comparable protocol. 


Comparable promises a type responds to the < operator, plus 


the == operator from Equatable; the other relations follow 
from those. 
*/ 
func pinComparables<T:Comparable> (value: T, lower: T, upper: T) 
-> T 
{ 
if value < lower { return lower } 
else if value > upper { return upper } 
else { return value } 
} 
pinComparables(-8.0, 0.0, 2.375) // => 0 
pinComparables(1.5, 0.0, 2.375) // => 1.5 
pinComparables(7.0, 0.0, 2.375) // => 2.375 


[kkkkkkkkkxkkkkkxkkxkkxkx Pinner factory KKK KK RK RK KR RR KK Re / 


/x Given a lower and upper bound, return a closure 
that takes a single argument of the same type, and 
returns the pinned value. 


*/ 
func limitPinner<T: Comparable> (lower: T, upper: T) 
oo E T 
{ return { value in pinComparables(value, lower, upper) } } 


/x The new function has the bounds baked-in; the only 
variable is the value to be pinned to those bounds. 


x / 
[KR KKK KK RK KKK KK Floating-point pinner: kk RRR RR RR KR RK Re / 


let pinPassingComponent = limitPinner(0.0, 2.375) 

// => a new function, (Double -> Double) 

printin("below: \(pinPassingComponent(-3.3)), " + 
"above: \(pinPassingComponent(3.3)), " + 
"within: \(pinPassingComponent(1.7))") 

) 

// => below: 0.0, above: 2.375, within: 1.7 


将 间隔 限制 为 Double 类 型 会 有 很 多 麻烦 ， 即 使 这 样 也 并 不 能 阻挡 我 在 后 面 的 章节 中 引入 Utilities.swift。 现 在 还 没有 结束 。 
String 类 型 也 是 可 以 比较 的 : 


[kkkkkkkkkkkkkkkkk*x String pinner: Kk KKK KK RRR RK RRR RK Re / 


let stringPinner = limitPinner("Cornelia", "Josh") 
// => (String -> String) 


for name in ["Alan", "Fritz", "Oren"] { 
println(name + ": " + stringPinner (name) ) 


// Alan: Cornelia 
/Jf Fritz: Fritz 
// Oren: Josh 


/* All that was necessary was to pass the limits to limitPinner(). 
Swift inferred the type for limitPinner(), and therefore 
pinComparables(), yielding a (String -> String) function 
specialized for that range. 


*/ 


好 ， 有 些 奇怪 。 那 dates 类 型 如 何 处 理 ? 在 Swift 中 ， 用 Foundation (Objective-C) 类 NSDate 表 示 dates 类 型 ， 但 是 
NSDate 本 身 并 不 可 比较 ， 如 果 在 dates 类 型 上 应 用 pinComparables() 函 数 ， 那 么 Swift 编 译 器 会 拒绝 执行 。 


但 是 我 们 可 以 让 NSDate 能 够 执行 比较 操作 : 


[kkkxkkkxkkxkxx Define < and == for NSDate: wx* 火 火 文火 火 火 火 广 炎 久 文火 // 

/* Swift lets you define operators, even your own, like "<+>", x*/ 
public 

func == (one: NSDate, another: NSDate) -> Bool 

{ return one.compare (another) == .OrderedSame } 

public 

fune < (one: NSDate, another: NSDate) -> Bool 


{ return one.compare(another) == .OrderedAscending } 


[KR KKK RK KK KKK KK Now NSDate is Comparable: KKK KKK KKK KKK Ke / 
extension NSDate: Comparable, Equatable {} 
[kkkkkkkkkkkxkkxxkx Define some dateS: x 火灾 火 火 炎炎 火炎 火灾 灾 炎 灾 炎 广 庆 类 // 
// Easy way to convert String to NSDate (en_US locale): 
let shortFormatter = NSDateFormatter () 
shortFormatter.dateStyle = .Shortstyle 


[kkkkkkkkkkkkkkkkk A macabre date span: Kk KKK RK RK RR KR Re / 
let £Birth = shortFormatter.dateFromString ("12/3/1955") 
let fDeath = shortFormatter.dateFromString ("7/15/2017") 


/xx*xx*x Create a pinning function for the life span: «*«x««/ 
let inFritzsLifetime = pinnerFunction(fBirth!, fDeath!) 


[kkkkkkkkkkkkkkkkkkk* Some other dates: kk KR KK RK RK RK KR RK / 

let pearlHarbor = shortFormatter.dateFromString ("12/7/1941") 
let cBirthday = shortFormatter.dateFromString ("12/23/1973") 
let probeReachesNeptune = shortFormatter.dateFromString ("8/9/2025") 


inFritzsLifetime (pearlHarbor! ) // => NSDate of 12/3/1955 
inFritzsLifetime (cBirthday! ) // => NSDate of 12/23/1973 
inFritzsLifetime (probeReachesNeptune!) // => NSDate of 7/15/2017 


全 注意 如 有 果 学 习 下 Apple 关 于 Swift 语言 的 文档 ， 你 会 找到 这 里 使 用 的 所 有 技术 ， 但 是 不 需要 了 解 所 有 的 内 容 ， 很 快 ， 你 需 
要 了 解 Swift 标准 库 。 附 录 B 会 告诉 你 在 哪里 浏览 完整 的 库 ， 不 过 这 里 有 一 个 快捷 方式 : 在 任何 Playgtound 中 添加 impott Swift, HAE 
command 键 ， 然 后 单 击 Swift。Xcode 将 会 显示 完整 的 类 列表 、 结 构 、 协 议 以 及 大 多 数 文档 注释 。 用 于 UNIX 层 的 Datwin 模 块 也 能 工 


作 ， 但 是 无 法 提供 信息 。 


Swift 编译 器 的 第 一 个 版 本 还 不 成 熟 。Apple Developer Tools 还 远 没 有 达到 成 熟 的 地 步 。 不 过 有 些 事 可 以 从 语言 的 逻辑 结 
构 和 潜在 的 意义 中 推断 出 来 。 





Swift 为 编译 器 提供 了 足够 的 权利 ， 它 可 以 根据 需要 泛 型 化 或 者 特例 化 代码 。 比 如 说 ， 相 同 的 函数 可 能 逢 动态 分 配 ， 作 为 
个 固定 地 址 的 函数 提供 ,或 者 复制 到 调用 者 的 代码 中 ， 这 依赖 于 它 在 整个 应 用 程序 中 怎么 使 用 ， 而 不 是 开发 者 自己 的 猜测 。 这 只 
是 众多 例子 中 的 一 个 ，Swift 语 言 的 逻辑 结构 让 它 能 生成 运行 速度 比 C++ 快 的 代码 ， 而 直到 现在 ，C++ 还 是 面向 对 象 语言 的 标 


杆 。 大 体 上 融 是 这 样 ， 但 实际 上 还 不 确定 。 


使 用 Swift， 为 什么 
本 书 第 一 部 分 坚持 使 用 C 语 言 ， 它 能 简化 概念 。 一 旦 我 们 开始 OS 和 OS X 开 发 ， 将 使 用 Swift。 


原因 是 : Apple 之 前 已 经 经 历 过 这 种 转换 ， 通 过 四 处 理 器 架构 (如 果 算 上 iOS 至 少 是 六 核 ) ， 两 种 字 节 类 型 ， 两 种 应 用 程序 框 
架 ，3 种 桌面 操作 系统 环境 ， 甚 至 在 Java 虚 拟 机 上 都 进行 过 尝试 。 仍 然 支 持 老 方法 ， 甚 至 支持 得 更 好 ， 年 限 也 会 更 长 。 但 是 最 
后 ， 老 方法 已 经 衰落 了 。 很 可 能 用 不 了 多 少年 ，Objective-C 就 将 风光 不 再 。 但 是 ，Apple 已 经 清楚 地 表明 了 它 的 观点 ，Swift 会 让 


应 用 程序 更 稳定 、 更 安全 ， 响 应 速度 也 会 更 快 。 


Cocoa 本 身 ， 尤 其 是 Foundation 不 会 消失 : 比如 NSDate 及 其 家 族 成 员 ， 作 为 Swift 的 核心 库 是 新 语言 发 展 很 多 年 才能 赶 得 上 的 
只 累 。 如 果 想 查看 Swift 标准 库 中 缺少 的 特性 ， 四 处 查看 下 ， 会 发 现 它 们 都 在 Cocoa 中 。 但 是 : 总 有 一 天 ，Apple 将 会 加 强 它 的 硬件 
和 API， 它 会 指定 优先 级 ， 让 开发 者 更 轻松 地 支持 它们 。 它 将 会 选择 如 何 分 配 它 的 ODS 和 工具 开发 精力 。 很 显然 ， 在 Objective-C 处 


于 统治 地 位 的 今天 ， 早 晚会 迎 来 Swift 选 勃 壮大 的 一 天 。 


对 于 新 的 开发 工作 ， 请 使 用 Swift 进行 开发 ， 除 非 明确 要 求 不 要 这 样 做 。 这 包含 已 经 使 用 Objective-C 构 建 的 产品 : Apple 已 经 


在 这 两 种 语言 之 间 建 立 了 桥梁 ， 让 它们 能 尽 可 能 地 平滑 过 渡 。 


当然 ， 这 种 话 我 已 经 说 了 40 多 年 ， 在 这 期 间 Apple 有 许多 新 技术 早已 沉没 在 记忆 当中 。 


5.5 编译 产品 


目标 文件 是 编译 过 程 中 最 基本 的 产品 : 通 单 你 最 天 心 的 仅仅 是 能 够 运行 并 且 测 试 的 产品 。 但 是 有 的 时 候 ， 编 译 器 会 确定 问题 
或 者 生成 一 些 你 无 法 理解 的 产物 。 在 这 种 情况 下 ， 学 习 编译 器 在 转换 源 代码 的 过 程 中 都 做 了 哪些 事 非 常 有 用 。 


同样 ， 构 建 过 程 会 生成 一 些 用 于 封装 重复 性 工作 的 文件 ， 比 如 说 编译 常规 的 头 文件 。 这 些 都 是 编译 器 的 产物 。 


5.5.1 PET 





当 你 追查 bug 的 时 候 一 一 或 者 仪 仪 是 好 奇 一 一 你 可 能 需要 查看 将 源 代码 转换 成 可 执行 产品 的 步骤 中 ， 编 译 器 所 做 的 工作 。 
Xcode 提供 了 一 种 查看 方法 。 


C 家 族 的 编译 器 的 执行 过 程 一 般 分 为 3 个 不 同 的 阶段 ， 每 一 个 阶段 都 要 需要 等 待 上 一 个 阶段 执行 完成 。 现 代 编 译 器 将 这 些 步 
又 都 合并 在 一 起 ， 由 此 能 够 更 好 地 理解 如 何 生 成 最 佳 代码 。 不 过 需要 注意 的 是 ， 那 些 阶 段 仍 旧 存 在 ， 并 且 能 得 到 每 个 阶段 的 产 


| 
Ao 


1) 预 编译 阶段 通过 简单 的 字符 串 茶 换 ， 将 你 编写 的 代码 输出 为 “真正 的 ” 源 代 码 。 当 编译 器 检测 到 项 nclude 和 其 mport 指 
令 时 ， 它 会 将 包含 文件 的 内 容 插 入 输出 流 中 。 由 #define 定 义 的 宏 命 令 都 会 展开 ， 并 替换 到 输出 流 中 。 条 件 指令 会 允许 或 者 禁止 
输入 文件 中 的 代码 段 。 


单 击 Related ltems 菜 单 ( 它 位 于 编辑 器 上 面 跳 转 栏 的 最 左 侧 ) ， 选 择 Preprocess， 束 能 看 到 预 编译 的 结果 。 编 辑 器 中 会 显 
示 出 当前 源 文件 完整 的 预 编译 输出 流 。 这 个 文件 可 能 会 很 长 ， 但 是 通过 确认 这 是 否 是 你 想 要 编译 的 源 代码 并 且 你 想 要 使 用 的 符号 
是 否 也 在 合适 的 位 置 ， 来 追踪 bug。 人 在 Assistant editor 跳 转 栏 的 根 选 项 中 选择 Preprocess， 融 会 在 你 正在 编辑 的 文件 旁边 显示 
出 文件 的 预 编 译 版 本。 同样， 也 可 以 通过 使 用 Product 一 Perform Action 一 Preprocess 命 令 达到 相同 的 目的 。 


2) 分 析 器 和 生成 器 (parser/generator) 会 简化 预 编译 阶 段 生 成 的 代码 ， 将 其 分 解 为 逻辑 化 的 结构 (分析) ， 同 时 生成 源 
文件 对 应 的 汇编 代码 (代码 生成 ) 。 


查看 汇编 列表 有 3 种 方法 : 


选择 Related Items 菜 单 下 面 的 Assembly 命 令 一 一 Related Item 菜 单位 于 跳 转 栏 最 左 侧 ， 见 图 5.4。 单 击 由 方块 组 成 的 图 


标 ，Assembly 选 项 就 在 点 开 后 的 下 拉 列 表 中 ， 这 样 编辑 器 中 的 内 容 就 会 蔡 换 成 已 经 转换 过 的 代码 。 
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图 5.4 任意 编辑 器 视图 上 面 跳 转 栏 最 左 侧 的 选项 就 是 Related Items 菜 单 ， 它 为 编辑 器 中 显示 的 文件 提供 了 很 多 可 选择 的 视图 
- Product—Perform Action 一 Assemble 命 令 也 能 达成 相同 的 效果 。 
- 在 Assistant 编 辑 器 跳 转 栏 中 选择 Assembly， 将 会 在 标准 编辑 器 中 显示 任何 文件 对 应 的 汇编 代码 。 


全 注意 这 里 指 的 并 不 是 本 章 一 开始 说 的 反 汇 编 代 码 。 它 并 非 源 于 最 终 产 品 的 可 执行 流 文件 。 它 只 是 编译 器 对 你 的 代码 分 
析 的 一 种 展示 ， 功 能 注释 都 与 clang 对 源 代 码 的 理解 有 关 。 


Ore 但 是 ， 直 到 Xcode 6.3, Assistant editor#eRelated Items 菜 单 都 没有 为 Swift 代码 生成 对 应 的 汇编 或 者 反 汇 编列 表 。 对 
Swift 的 完整 支持 需要 一 定 的 时 间 。 代 码 重 构 是 另 一 个 例子 。 我 们 可 以 期 待 这 些 功能 很 快 都 会 回来 的 。 


3) 汇编 器 (assembler) 将 会 读 取 汇编 代码 ， 然 后 将 其 分 解 为 对 和 象 文件 中 的 可 执行 字 节 流 ， 其 中 包含 链接 器 填充 的 引用 。 
命令 行 工 具 otool 中 有 大 量 天 于 检查 对 象 文件 和 库 文件 的 选项 ， 也 具有 反 汇 编 和 文件 布局 功能 ， 以 及 少量 编辑 选项 。nm 这 个 工 
具 对 于 检查 库 文件 中 的 符号 表 非 常 实 用 。 更 多 详细 内 容 可 参见 man otool 和 man nm 命令 。 


9 注意 ”这 种 3 步 的 转换 操作 在 Swift 中 没有 用 : 它 没有 预 处 理 器 ， 所 在 在 分 析 整 个 程序 之 前 ， 编 译 器 无 法 精确 地 决定 生成 
什么 代码 。 


5.5.2 ” 预 编译 


Mac 和 iOS 应 用 通过 框架 (framework) 组 织 ， 框 以 包含 动态 库 、 头 文件 ， 以 及 定义 、 链 接 到 操作 系统 中 的 资源 ， 还 有 用 户 
界面 服务 及 其 他 服务 。 框 架 中 包含 了 大 量 的 头 文件 。 在 早 些 时 候 ， 为 了 加 快 编译 速度 ， 程 序 员 会 仔细 挑选 想 要 包 合 的 系统 头 文 
件 。 但 是 Cocoa 框 架 中 头 文 件 相互 依赖 的 情况 非 带 严重， 所 以 无 法 使 用 这 种 技巧 (事实 上 ，Apple 会 郑重 警告 那些 尝试 从 框架 中 
抽出 部 分 头 文件 的 行为 ) 。 


BUSRA MF 


框架 头 文件 通常 是 C 家 族 的 实现 文件 最 先导 入 的 文件 ， 无 论 是 通过 直接 还 是 间接 方式 。 可 以 设置 一 个 前 缀 文件 (prefix 
file) ， 它 能 自动 插入 所 有 文件 的 源 文件 流 中 。 事 实 上 ， 当 实例 化 一 个 10S 或 者 OS X 项 目的 时 候 ，Xcode 玖 会 自动 生成 一 个 后 绥 
为 .pch 的 文件 ， 并 且 建 立 构建 设置 以 插入 其 中 。 一 个 典型 的 前 缀 文件 如 下 所 示 : 
#ifdef _ OBJC 


#import <Cocoa/Cocoa.h> 
#endif 


这 种 方法 很 方便， 但 是 却 没 有 解决 每 当 编 译 一 个 文件 的 时 候 ， 是 否 需 要 读 取 并 转换 前 缀 的 问题 。 以 .pch 为 扩展 名 的 文件 为 解 
决 方案 提供 了 一 毕 线 系 : 这 个 文件 最 初 的 目标 是 作为 预 编译 头 文件 的 源 ， 如 果 你 选择 了 预 编译 ，clang 将 会 读 取 .pch 文 件 并 且 保 
存 分 析 状 态 。 后 面 所 有 使 用 前 绥 头 文件 的 地 方 都 会 重新 载 入 已 经 保存 的 状态 ， 不 用 再 花费 时 间 重 复 编译 ,节约 了 大 量 时 | 间 。 对 于 
预 编 译 ， 还 有 另外 一 个 构建 设置 ， 黑 认 情 况 下 ， 会 局 用 这 个 设置 。 


sc 注意 同样 ， 这 一 条 仅 对 C 家 族 的 语言 有 效 ; Swift 依赖 从 其 他 源 文件 中 获取 的 模块 和 API。 
模块 


Clang 为 Xcode 5 提供 了 一 些 C 家 族 语言 的 模块 。 设 计 者 看 到 了 一 个 问题 : 理论 上 ，#include 和 #import 命 令 已 经 成 为 C 语 言 
的 一 部 分 ， 因 为 它 不 过 是 将 一 个 文件 中 未 解释 的 文本 输出 到 另外 一 个 文本 中 而 已 。 补 包含 的 文件 定义 了 符号 和 安 ， 编 译 器 会 按照 
执行 的 先后 顺序 来 解析 这 些 符号 和 安 。 如 果 你 重新 排 询 源 文件 中 包含 文件 的 顺序 ， 那 么 重新 排列 的 定义 可 能 会 改变 它们 的 意义 。 
进一步 ， 因 为 你 可 以 在 包含 文件 中 插入 定义 ， 所 以 没有 办 法 能 够 保证 能 企 实 现 文 件 中 共享 预 编译 的 包含 文件 ， 即 使 同样 顺序 的 包 
台 文 件 ， 也 可 能 产生 完全 不 同 的 代码 。 


llvm 工 程 师 对 此 的 回复 是 : 因为 系统 是 由 模块 组 成 的 ， 这 些 模 块 会 添加 到 C 家 族 的 编程 语言 中 。 不 像 预 处 理 器 引入 的 头 文 
件 ， 每 个 模块 都 是 独立 的 单元 ， 并 且 可 以 作为 完全 分 析 过 的 单元 进入 编译 状态 中 。Swift 按 照 模块 化 进行 设计 ， 可 以 像 


Objective-C 一 样 使 用 。 

这 样 做 要 付出 一 定 代价 : 为 了 获得 最 大 收益 ， 你 无 法 通过 插入 目 己 的 安定 义 来 修改 包含 的 头 文件 的 效果 (为 此 ， 它 强制 编译 
器 生成 一 个 唯一 的 模块 ) 。 如 果 你 曾经 认为 这 么 做 是 个 好 主意 ， 那 都 是 裤头 文件 的 糟糕 设计 逼 的 。 如 果 你 仔细 探究 头 文件 的 依赖 
顺序 ， 那 么 会 发 现 这 么 做 太 疯 狂 ， 还 是 停止 吧 ，。 


举 一 个 实际 的 例子 ，C 标 准 库 可 能 会 封装 到 一 个 名 为 std 的 模块 中 ， 你 可 能 仅 需 要 引入 部 分 子 模块 ， 比 如 说 std.io 或 者 
std.strings。 你 可 以 通过 替换 框架 头 文件 ， 使 用 @import 导 入 Objective-C 目 录 直 接 调用 模块 的 功能 ， 比 如 将 


#import <Foundation/Foundation.h> 


BIRA 


@import Foundation; 


按 住 command 键 单 击 模 块 名 称 ， 残 会 跳 转 到 对 应 的 框架 头 文件 下 。 


但 是 ， 没 有 一 个 C/C++/Objective-C 的 作者 打算 使 用 @import 指 令 某 换 预 处 理 指 令 。 对 于 那些 遗留 代码 ， 当 clang 遇 到 
#include 或 者 #import 的 时 候 ， 它 会 迅速 构建 一 个 模块 ， 然 后 开始 使 用 它 。 


Apple 已 经 将 系统 函数 库 模 块 化 了 ， 所 以 糟 料 的 #include 和 重新 编译 循环 已 经 消除 了 。 如 果 检 查 源 代码 的 预 处 理 版 本 ， 你 会 
皮 现 系统 的 头 文件 都 已 经 做 茶 换 为 “ 隐 式 导入 (implicit imports) ”。 如 果 你 想 要 目 己 预 构 建 这 些 模 块 ， 你 可 以 写 一 个 
module.map 文 件 来 质 述 这 个 结构 。 


module.mapx 这 个 文件 还 做 了 些 别 的 事 : 它 使 用 模块 将 库 联 系 在 一 起 。 如 果 你 从 一 个 模块 化 的 框架 中 #include 或 #import 一 
个 头 文件 ， 你 不 需要 将 这 个 模块 加 入 Link Binary With Libraries 构 建 阶段 中 。 


Swift 添加 了 另外 一 个 级 别 : 当 不 同 库 的 对 象 使 用 了 相同 的 名 称 时 ，Objective-C 代 码 会 产生 空间 冲突 。 如 果 足 够 押运 ， 链 接 
器 将 会 检查 到 多 重 定 义 ， 拒 绝 生成 可 执行 文件 。 否 则 (比如 Objective-C 中 使 用 的 动态 符号 ) ， 直 到 应 用 程序 在 非常 奇怪 的 地 方 
出 现 非 党 奇怪 的 错误 的 时 候 ， 你 才能 友 现 这 个 问题 。 


出 于 这 个 原因 ，Swift 使 用 模块 将 符号 限制 在 模块 中 (公共 符号 也 放 入 了 模块 中 ) 。 你 目 己 的 应 用 程序 也 是 一 个 模块 ， 名 称 
基于 App 的 名 称 : ASCII 字 母 数字 没有 更 改 ， 其 他 内 容 用 下 划 线 蔡 换 。 


如 果 你 用 一 种 可 能 会 引起 冲突 的 方式 使 用 另外 一 个 模块 的 符号 ，Swift 会 要 求 你 使 用 这 个 符号 之 前 ， 加 上 模块 的 名 称 作为 前 
a: 如 果 有 个 类 的 名 称 是 Parser， 同 时 你 使 用 了 一 个 库 XMLParser， 它 提供 了 自己 的 类 Passer， 那 么 使 用 这 个 库 中 类 的 安全 方法 


是 XMLParser.Parser。 


Xcode 6 针对 Objective-< 的 新 项 目 和 -target 模 板 默 认 情况 下 也 被 设置 为 使 用 模块 。 如 果 你 想 要 使 用 自动 链接 的 功能 ， 请 将 
Link Frameworks Automatically 设 置 为 YES9， 默 认 情 况 下 也 是 这 么 设置 的 。 


还 有 很 多 问题 我 没 能 回答 ， 请 访问 http://clang.llvm.org/docs/Modules.html， 学 习 更 多 的 内 容 。 


本 章 简单 回顾 了 一 下 编译 和 链接 一 个 程序 时 所 做 的 工作 。 我 们 看 到 编译 器 不 仅仅 会 将 代码 转化 为 可 执行 的 机 器 码 ， 而 且 还 会 
做 一 些 变 形 。 在 构建 一 个 可 执行 文件 的 过 程 中 ， 最 艰巨 的 任务 不 是 转换 ， 而 是 为 数据 和 代码 预 分 配 空间 以 及 如 何 完 成 链接 的 最 后 
阶段 。 在 静态 链接 器 中 ， 链 接 可 以 一 次 性 完成 。 但 是 iOS 和 OS X 非 常 依赖 动态 链接 ， 有 很 多 工作 都 是 在 程序 开始 启动 的 时 候 完 成 
的 。 


Om ”添加 库 target 


passer_rating 函 数 是 来 之 不 易 的 巨大 成 束 。 很 少 有 程序 只 是 这 样 一 个 简单 的 命令 行 工具 ， 所 以 让 我 们 将 这 些 服务 封 荫 起 
来 ， 供 其 他 程序 使 用 。 


当然 ， 也 许 不 需要 这 么 做 ， 但 是 在 这 个 过 程 中 ， 会 引入 一 些 重 要 的 扩 巧 。 所 以 你 可 以 为 pass_rating 创 建 一 个 静态 库 (静态 
库 指 的 是 可 复 用 代码 的 存档 文件 ) ， 将 代码 从 passer-rating 工 具 中 移动 到 一 个 新 库 中 ， 然 后 将 它 重 新 链接 到 这 个 命令 行 工具 
中 。 


6.1 添加 target 


创建 库 并 不 需要 重新 创建 新 项 目 。 在 Xcode 中 打开 项 目 passer-rating， 单 击 项 目 导航 器 顶端 表示 项 目的 图 标 ， 就 可 以 打开 
Project/Target 编 辑 器 。 


像 所 有 的 编辑 器 一 样 ， 最 上 方 是 一 个 跳 转 栏 ， 下 面 一 栏 包含 组 织 target 设 置 的 选项 卡 。 最 左边 有 一 个 带 有 提示 三 角 的 按钮 ， 
这 个 按钮 可 以 打开 Project/Target 编 辑 器 能 够 处 理 的 对 象 的 主要 列表 。 如 果 在 编辑 器 左边 看 不 到 主 列表 ， 那 就 单 击 这 个 按钮 打开 
它 。 这 个 列表 包含 项 目 本 身 的 列表 ， 以 及 唯一 的 target: passer-rating， 见 图 6.1。 


N 
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主 列表 最 下 方 有 一 个 + 按钮 ， 单 击 它 。 
这 样 就 会 生成 一 个 New Target 帮 助 界 面 ， 这 个 界面 的 组 织 方 式 与 之 前 已 经 见 到 的 新 建 项 目 和 文件 的 组 织 方 式 一 致 。 
1) 在 左边 栏 中 ， 选 择 OS X 一 Framework&Library。 


2) 你 会 看 到 可 供 选 择 的 可 链接 的 target。 选 择 Library (passer rating 不 会 涉及 除了 标准 C 以 外 的 库 文件 ， 也 不 需要 框架 提 
供 的 动态 链接 ) ， 然 后 单 击 Next 按 钮 。 


O | passer-rating | Build passer-rating: Succeeded | 7/5/14 at 5:45PM 


m a l 小 AS Se A DH | Fà passer-rating 


F 入 Build Settings Build Phases Build Rules 


F| | passer-rating PROJECT + 
[e| main.c Fà passer-rating 
le] rating.c E 
[h] rating.h 
|| Products ma ¥ Compile Sources (2 items) 


E Target Dependencies (0 items) 
TARGETS 


lel rating.c 
le] main.c 


十 


¥ Link Binary With Libraries (0 items) 


十 


EkE Copy Files (0 items) 





图 6.1 单 击 Project/Target 编 辑 器 选项 卡 栏 最 左边 的 按钮 ， 就 可 以 打开 编辑 器 可 以 处 理 的 对 象 的 主 列表 


3) 为 产品 命名 。 可 能 你 已 经 友 现 了 ，UNIX 静 态 库 名 都 类 似 于 libname.a 这 种 形式 。 不 用 担心 ， 仪 需要 提供 基本 的 名 称 
passer， 构 建 系统 会 负责 文件 的 命 


4) 在 Framework 弹 出 窗口 中 选择 None (Plain C/C++Library) 。 
5) 选择 Type:Static， 人 然后 在 Project 这 一 项 选择 passer-rating。 
6) 单 击 Finish 按 钮 。 


编辑 器 区 域 中 会 显示 一 个 Target 编 辑 器 ， 显 示 新 的 “passer”target。 对 于 简单 的 target 如 C 库 和 工具 ， 编 辑 器 有 3 个 选项 


- Build Settings 可 以 设置 控制 target 如 何 构 建 的 全 部 选项 。 即 使 对 这 么 简单 的 库 来 说 ， 也 有 不 少 控 制 选项 。 通 过 选择 Basic 和 
Combined 过 滤器 ， 能 减少 一 些 选项 。 有 一 些 大 写 的 设置 ，Xcode 称 之 为 User-Defined， 它 们 都 指 代 clang。Xcode 之 所 以 这 样 做 ， 是 


为 passet 库 还 没 包含 任何 源 文 件 ， 同 时 Xcode 也 不 知道 任何 与 clang 有 关 的 内 容 ， 直 到 在 构建 过 程 中 开始 使 用 它 。 


- Build Phases 在 第 5 章 中 曾经 见 过 ， 它 描述 了 target 的 组 件 以 及 在 构建 过 程 中 如 何 使 用 这 些 组 件 。 当 创建 target 的 时 候 ， 它 是 在 
Xcode 中 首先 要 展示 给 你 的 内 容 。 


- Build Rules 允 许 你 更 改 Xcode 构 建 系 统 用 于 处 理 target 包 含 的 文件 所 使 用 的 工具 。 你 可 以 定义 自己 的 规则 ， 这 样 你 就 能 添加 
自 定义 文件 和 处 理 过 程 ， 但 是 大 多 数 开发 者 都 不 会 更 改 这 些 选 项 。 在 第 25 章 中 可 以 学 到 更 多 内 容 。 


选择 Build Phases 选 项 卡 。 
target 


你 做 了 什么 ? 什么 是 target? 让 我 们 回 退 到 target 编 辑 器 的 细节 。 


target 摘 述 了 Xcode 中 单个 构建 过 程 : 它 有 一 个 指定 的 产品 、 一 组 生成 产品 所 需 的 特定 文件 ， 以 及 构建 过 程 中 需要 的 一 些 特 


target 由 构建 阶段 (build phase) 组 成 。 一 个 构建 阶段 接受 属于 其 target 的 文件 ， 并 按照 特定 的 方法 处 理 这 些 文件 。 源 文 
件 (.c、.swift、.m 和 .cpp 是 最 常见 的 文件 ， 但 是 也 包含 一 些 针 对 其 他 编译 器 的 文件 ) 都 会 进入 Compile Sources 阶 段 ， 库 文件 
在 Link Binary With Libraries 阶 段 中 会 使 用 到 ， 等 等 。 


Ht 
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第 25 章 会 详细 介绍 构建 阶段 和 它们 在 Xcode 构建 系统 中 所 起 的 作用 。 


你 可 以 根据 自己 的 喜好 更 改 文件 和 设置 ， 但 是 决定 构建 过 程 的 产品 类 型 不 能 更 改 。 比 如 说 ， 如 果 开 始 构 建 的 是 一 个 静态 库 文 
件 ， 那 么 当 你 需要 一 个 动态 库 文件 的 时 候 ， 惑 没 那么 弟 运 了 ， 你 不 得 不 重新 为 动态 库 创 建 一 个 target， 然 后 再 将 源 文 件 添加 到 这 
个 target 中 。 


6.2 targetKK 


target 由 产品 (由 你 措 定 ) 、 构 建设 置 (你 认可 的 ) 及 成 员 文 件 组 成 ， 不 过 passer 这 个 target 还 未 包含 任何 源 文 件 ， 需 要 添 


加 一 些 文件 进去 ， 尤 其 是 rating.c。 


6.2.1 添加 文件 到 target 中 


有 3 种 方式 可 以 将 一 个 文件 添加 到 一 个 target 当 中 。 


` 在 项 目 导 航 器 中 单 击 项 目 ， 然 后 从 Tatgets 列 表 中 选择 tafget 库 passef， 然 后 再 选择 Build Phases 选 项 卡 。 在 项 目 导 航 器 中 找到 
tating.c 这 个 文件 ， 将 它 拖 慢 到 Compile Sources 这 个 阶段 。 标 签 会 显示 这 个 阶段 包含 一 项 内 容 ， 同 时 这 个 列表 会 被 展开 ， 列 表 中 显 


示 fating.c 这 个 文件 ， 见 图 6.2。 


Build Settings Build Phases Build Rules 
中 


> Target Dependencies (0 items) 


Y Compile Sources (1 item) 


c| rating.c 


-'- ma 


» Link Binary With Libraries (0 items) 


bE Headers (0 items) 





H62 ”可 以 将 一 个 源 文 件 从 项 目 导 航 器 中 拖 到 Compile Sources 阶 段 ， 这 样 就 向 target 中 添加 了 一 个 文件 。 使 用 这 种 方法 ， 可 以 获 
得 这 个 文件 在 构建 过 程 中 所 起 的 作用 的 最 大 控制 权 


“ 撤销 这 个 操作 仅 需要 在 Compile Source 表 中 选中 文件 rating.c， 然 后 单 击 列表 下 面 的 -按钮 (或 者 按 Del 键 ) ， 然 后 就 可 以 尝试 
用 另外 一 种 方式 向 tatget 中 添加 文件 。 


GIE ”从 一 个 甚至 多 个 构建 阶段 中 移 除 一 个 文件 ， 并 不 会 从 项 目 中 删 掉 这 个 文件 。 


现在 单 击 Compile Sources 列 表 底 部 的 + 按钮 ， 会 出 现 一 个 包含 项 目下 拉 列 表 的 表 。 单 击 rating.c， 然 后 单 击 Add 按 钮 。 如 
果 你 单 击 Add other， 那 么 融 可 以 在 硬盘 上 选取 文件 ， 一 次 性 在 构建 阶段 和 项 目 中 同时 添加 选中 的 文件 。 


第 3 种 方法 通过 file-to-target 完 成 。 在 项 目 导 航 器 中 单 击 rating.c， 然 后 单 击 工具 栏 最 右 端 View 控 件 中 右边 的 segment， 显 

示 出 工具 区 。 确 保 第 一 个 选项 卡 File inspector 处 于 选中 状态 。File inspector 能 让 你 控制 Xcode 处 理 所 选 文件 的 方式 (如果 在 项 

导航 器 中 选择 多 个 文件 ， 那 么 这 个 设置 会 影响 所 有 的 文件 ) 。 工 具 区 中 有 一 个 部 分 叫 作 Target Membership， 它 列 出 了 项 目 
中 全 部 target。 对 于 rating.c， 单 击 passer 旁 边 的 复 选 框 ( 风 图 6.3) 。 


identity and Type 
Name rating.c 


Type Default - C Source 





Location Helative to Group 








rating.¢c 
Full Path /Users/tritza/Dropbox/Book/ 
X6StF/Sample Code/ 
Chapter 6/passer-rating/ 
passeér-rating/rating.c 





=+ 





Target Membership 
| M passer-rating 
Ñi passer 









Text Settings 
Text Encoding Unicode (UTF-8) LH 


Line Endings Default - OS X / Unix (LF) 


图 6.3 File inspector 中 的 表格 能 让 你 选择 菜 个 文件 被 哪个 target 使 用 


从 build-phase 添 加 文件 的 优点 是 你 能 够 控制 文件 参与 哪个 阶段 。 的 确 ，.c 文 件 几乎 总 是 需要 编译 ， 但 是 假设 你 正在 创建 一 
个 程序 员 在 OS X 上 使 用 的 编辑 器 ， 这 个 编辑 器 中 包 合 一 个 .c 的 文件 模板 。TemplateFile.c 文 件 看 起 来 像 一 个 C 源 代码 一 一 它 的 确 
是 C 源 代码 一 一 但 是 你 想 要 它 作 为 一 个 文本 文件 打包 到 程序 中 ， 而 不 是 作为 源 代码 被 编译 。 所 以 ， 这 个 文件 所 处 的 阶段 应 该 
Copy Files ( 仪 应 用 程序 和 bundle target 可 用 ) ， 而 不 是 Compile Sources。 如 果 你 从 build phase 中 添加 这 个 文件 ， 惑 不 会 出 


WRX. 


从 文件 这 边 将 目 身 添加 到 target 中 也 有 目 己 的 优势 : 如 果 一 个 项 目 有 很 多 target， 复 选 框 能 让 你 一 次 性 设置 所 有 的 从 属 天 
系 ， 而 不 用 进入 每 个 Target 编 辑 器 中 逐个 添加 文件 。Xcode 会 目 行 选择 这 些 文 件 应 该 进入 哪个 阶段 ， 而 且 它 一 般 都 不 会 选 错 。 


当 创建 一 个 新 文件 的 时 候 ， 使 用 File 一 New 一 File.… (¢6N) 命令 ， 这 时 能 看 到 一 个 给 target 赋 值 的 快捷 方式 : 新 文件 
的 “保存 文件 ”对 话 框 中 包 合 一 个 将 此 文件 添加 a 到 哪 一 个 target 中 的 选择 器 。 与 之 类 似 的 还 有 添加 文件 ,，File 一 Add Files to... ( 
CEA) ， 也 会 看 到 一 个 target 选 择 器 。 同 样 ，Xcode 也 会 自行 选择 一 个 target， 见 图 6.4。 


Owe tafpet 选 择 器 可 能 自动 选择 你 想 要 的 那个 target， 这 一 点 很 容易 被 忽略 ， 而 且 会 导致 一 些 让 你 很 困惑 的 错误 。 


然而 ， 当 你 把 rating.c 文 件 添 加 到 jpasser 库 的 时 候 ， 记 得 将 它 从 passer-rating 这 个 target 中 移 除 。 使 用 库 文件 的 意义 就 在 于 
客户 端 不 需要 再 引入 提供 服务 的 源 代码 。 


Save As: Another 
Tacs: 


Where: passer-rating 


Group | passer-rating 


Targets | 加 加 passer-rating 
Rd passer 


Cancel 





x 


图 6.4 ”创建 新 文件 的 保存 文件 界面 包含 一 个 选择 该 文件 将 参与 哪个 target 构 建 的 表格 。 通 常 这 个 表格 都 会 被 设置 成 最 后 选择 的 


target 


6.2.2 ”target 中 的 头 文件 


rating.h 该 如 何 处 理 ? 无 法 将 它 从 文件 这 边 加 入 到 应 用 程序 的 target 当 中 : 因为 头 文 件 本 身 并 不 能 被 编译 一 一 它们 对 实现 文 
件 没有 什么 帮助 。 如 果 出 于 某 些 原 因 ， 你 想 要 将 它们 加 入 到 应 用 程序 包 中 ， 那 么 可 以 将 它们 拖 入 Copy Bundle Resources 阶 段 


rating.h 可 以 添加 到 library target 中 ， 你 可 以 选择 头 文 件 在 产品 中 所 扮演 的 角色 : 
- Project， 如 果 头 文件 仅仅 在 项 目 中 出 现 ， 那 么 它 属于 构建 的 一 个 元 素 。 
- Public， 如 果 头 文件 需要 安装 到 /uset/local/include 或 者 框架 的 Headet 目 录 中 ， 那 么 它 就 是 公开 的 。 
- Private， 如 果 头 文件 被 安装 到 框架 的 PrivateHeader 目 录 ， 那 么 它 就 是 私有 的 。 


target 编 辑 器 中 的 Build Phases 选 项 卡 的 一 个 阶段 是 Headers。 这 个 阶段 仅 对 库 和 框架 target 有 效 。 展 开 就 会 看 到 下 面 分 为 
3 个 部 分 : Public、Private 和 Project。 癌 这 里 面 添加 文件 的 过 程 与 向 其 他 构建 阶段 添加 文件 的 过 程 一 样 : 将 头 文件 从 项 目 导航 器 
中 抑 到 合适 的 位 置 ; 或 者 单 击 + 按钮 在 浏览 器 中 选择 一 个 头 文件 。 后 一 种 方法 将 文件 放 入 project 这 个 分 类 ， 不 过 你 可 以 将 它 拖 


动 到 你 想 要 的 分 类 。 


6.3 从属 target 


工具 栏 中 的 Run 和 Stop 按 钮 旁边 是 Scheme 控 件 ， 这 个 控件 可 以 设置 某 些 操作 (比如 ， 运 行 产品 ) 用 到 的 target 和 CPU 架 
构 。 选 择 passer 一 My Mac， 然 后 选择 Product 一 Build 命 令 。Xcode 残 会 构建 这 个 库 文件 ， 然 后 会 看 到 “ 库 文件 构建 成 功 ”.。 


现在 将 scheme 弹 出 菜单 切换 到 passer-rating-My Mac， 然 后 单 击 Run， 你 会 发 现 构建 失败 。 让 我 们 看 看 为 什么 会 失败 ， 
选择 报告 导航 器 (Report navigator) (导航 区 域 顶端 最 后 一 个 选项 卡 ) ， 它 会 列 出 项 目 最 近 的 历史 记录 的 事件 ， 最 顶端 是 刚刚 
尝试 执行 的 构建 日 志 。 选 中 它 ， 能 看 到 所 有 的 构建 内 容 ， 其 中 有 两 项 前 面 带 有 红色 的 “!” 图 标 。 


这 一 项 说 问题 发 生 在 “链接 ”阶段 。 单 击 这 一 行 最 右 侧 带 有 横 线 的 按钮 ， 就 能 看 到 这 一 部 分 的 构建 输出 ， 最 后 一 部 分 是 链接 
器 发 出 的 消息 : 


Undefined symbols for architecture x86_64: 
" passer_rating", referenced from: 
_main in main.o 
ld: symbol(s) not found for architecture x86_64 
clang: error: linker command failed with exit code 1 (use -v to see 
invocation) 


Ai Ai, maine passer rating， 但 是 链接 器 却 找 不 到 对 应 的 国 数 ， 见 图 6.5。 


ER) o P SS passer-rating | Bulld passer-rating: Failed | Today at 3:08 PM 


O0 m a4 A > ED Q | BE < 国 passer-rating » Build passer-rating : 3:08:26 PM 


By Group | By Time | All | Recent | | | All Messages | All Issues Errore Only 


Build target passer-rating 
Project passer-rating | Configuration Debug | Destination My Mac | SDK OS X 10.10 
ae “Tatling.h © Compile maine ...in /Users/tritza/Desktop/Chapter 7/passer-rating/passer-rating 
“i Y! Link /Users/fritza/Library/Developer/Xcode/DerivedData/passer-rating-foatlgktjzfxdiebtgjzroovksg/Build/Pro... ! 2 


Ld /Users/fritza/Library/Deve loper/Xcode/DerivedData/passer—rating— 

Togtlgktjztfxxdfebtg]zroovksa/ Build/Products/Debug/passer—rating normal x#&6_64 

cd "/Users/fritza/Desktop/Chapter ?/passer—rating" 

export MACOSX DEPLOYMENT TARGET=168 .9 

Applications/Ncoode6-Beta3: app/Contents/DevelLoper/Toolchains/XcodeDefault.actoolchain/usr/ 
bin/clang -arch x86_64 -isysroot /Applications/Xcode6-Betad. app/Contents/Developer/Platforms/ 
MacO5X.platform/Deve loper/SDKs/Mac05X18.16.sdk —L/Users/fritza/Library/Deve Loper/Xcode/ 
DerivedData/passer—rating-fogtlgktjzfexdfebtgj2zroovksg/Build/Products/Debug -F/Users/fritza/ 
Library/Deve Loper/Xcode/DerivedData/passer—rating—fogt Loktj ztxxdfebtgjzroovksg/Build/ 
Products/Debug -filelist /Users/fritza/Library/Developer/Xcode/DerivedData/passer-rating- 
fogtloktjzfxadfebtgjzroovksg/ Build/Inte rmedistes/passer—rating.build/Debug/passer— 
rating.build/Objects—-normal/x85_64/passer-rating.LinkFileList -mmacessx—version—nin=16.9 一 
Mlinker -dependency_info -Xlinker /Users/fritza/Library/Deve loper/Xcode/DerivedData/passer- 
rating-fogtlLokt jzfxxdfebtgj zroovksq/Build/Intermediates,/passer-rating.build/Debug/ passer- 
rating. bulld/0bjects-normal/x66_64/passer-rating_ dependency_info.dat -o /Users/fritza/ 
Library/Deve Loper/Xcode/DerivedData/passer-rating—fogt Loktjztxxdfebtg{zroovksg/Suild/ 
Products/Debug/passer-rating 











Under ined symbols for architecture ~86_64:; 
_passer_ rating", referenced from: 
main in nain.o 

ld: symbol(s) not found for architecture xB6_64 
clang: errar: Linker command failed with exit code 1 (use -vw to see invocation) 
@® "_passer_rating", referenced fram: 

main in main.o 

Symbol|s) not found for architecture 166_64 
Ü Linker command failed with exit code 1 (use -v te see invocation) 
Build failed 7/12/14, 3:08 PM 
2 errors 





图 6.5 ”报告 导航 器 列 出 了 构建 出 现 的 全 部 问题 。 单 击 编辑 器 中 的 一 项 ， 就 会 定位 到 对 应 的 错误 位 置 。 在 这 个 例子 中 ， 错 误 出 现 
在 链接 阶段 ， 所 以 编辑 器 显示 出 了 对 应 的 链接 命令 并 输出 了 错误 消息 


个 错误 很 容易 理解 : 你 移 除 了 rating.c 后 ， 也 没有 了 passer rating 这 个 国 数 ， 却 没有 告诉 passer-rating 这 个 target 去 哪里 
找到 对 应 的 函数 。 的 确 ，rating.c 这 个 文件 和 库 都 在 这 个 项 目 中 ， 但 这 是 用 到 这 个 轴 数 的 地 方 是 passer-rating 这 个 target， 而 不 
是 project。target 决 定 了 什么 文件 应 该 参与 passer-rating 这 个 工具 的 构建 。 


Oza 第 25 章 会 深入 介绍 如 何 解释 构建 脚本 。 


6.3.1 添加 库 


所 以 你 需要 修改 passer-rating 这 个 target， 也 融 是 训 ， 你 需要 进入 Target 编 辑 器 。 你 对 这 个 操作 已 经 轻 车 束 路 : 项 目 导航 
器 中 ， 在 列表 的 最 上 面 选择 passer-rating 这 个 项 目 。 在 target 列 表 中 ， 选 择 passer-rating， 然 后 单 击 Build Phases 选 项 卡 。 


你 想 要 将 libpasser.a 链 接 到 passer-rating，libpasser.a 也 就 是 passer 这 个 target 的 产物 。 很 简单 : 打开 Link Binary With 
Libraries 这 个 构建 阶段 ， 然 后 单 击 + 按钮 ， 融 会 出 现 一 个 市 有 两 部 分 列表 的 界面 。 第 一 部 分 的 标题 是 passer-rating Project, © 
列 出 了 这 个 项 目 生 成 的 库 文件 ， 在 本 例 中 ， 只 有 libpasser.a。 选 择 这 个 文件 ， 然 后 单 击 Add 按 钮 。 


Oe 名 称 libpasset.a 的 劳 边 还 有 一 个 包含 Requifted 和 Optional 这 两 个 选项 的 弹出 菜单 。 通 和 常 使 用 Requifted 即 可 ， 等 你 经 验 
足够 丰富 ， 能 够 明白 为 什么 不 使 用 Required 的 时 候 ， 再 使 用 Optional 即 可 。 


如 果 你 正在 构建 的 是 一 个 Cocoa (iOS 或 者 OS X) 应 用 程序 ， 你 也 可 以 在 Tatget 编 辑 器 中 Genetal 选 项 卡 的 Linked Frameworks 
and Libraries 部 分 中 添加 库 文 件 。 


现在 单 击 Run， 构 建成 功 ， 程 序 passer-rating 开 始 运 行 。 当 你 输入 一 些 测 试 数据 的 时 候 ， 它 也 能 正音 工作 ， 一 切 顺 利 。 


隐 式 依赖 


在 传统 的 构建 系统 中 ， 你 的 工作 可 能 还 没有 完 。 假 设 你 在 tating,c 中 添加 了 一 个 函数 ptintf0 ， 这 个 更 改 可 能 会 引起 libpasset.a 重 
新 构建 。 


更 改 还 可 能 会 停止 ， 当 一 个 产品 (比如 passet-rating) 为 依赖 的 库 文件 发 生 更 改 而 必须 更 新 的 时 候 ， 应 该 告诉 构建 系统 。 
rating.c 中 代码 的 更 改 导 致 的 库 更 新 ， 不 会 让 链接 到 passer-rating 中 的 库 也 发 生 更 新 ， 所 以 当 程 序 运 行 的 时 候 ， 也 无 法 调用 达 数 
printt() o 


Xcode 在 这 方面 处 理 得 比较 好 。 当 它 看 到 一 个 库 tafget 的 产品 被 用 于 其 他 tatget 中 的 时 候 ，Xcode 会 让 对 应 的 库 文 件 保 持 同 步 更 
新 ， 所 以 使 用 这 个 库 文件 的 target 总 是 会 用 到 最 新 的 库 文件 。 这 几乎 总 是 你 想 要 的 结果 。 


如 果 这 不 是 你 想 要 的 结果 (有 时 候 你 可 能 想 要 与 旧版 本 的 项 目 保持 兼容 ) ， 那 么 请 使 用 Scheme 编 辑 器 做 相应 的 修改 。 打 开 
Scheme editor 的 方法 是 使 用 Product 一 Scheme 一 Edit Schemehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/... ( de<) 命令 (在 美式 键盘 中 ， 这 个 操作 等 同 于 介 36 


period) 。Scheme 编 辑 器 控制 着 构建 并 运行 target 的 环境 。 


请 确保 编辑 器 顶端 的 弹出 菜单 选中 了 passet-ratineg， 然 后 在 主 列表 中 选择 Build 选 项 。 取 消 色 选 Find Implicit Dependencies。 完 成 
之 后 单 击 OK 按钮 。 


现在 ， 当 指定 target 重 新 构建 的 时 候 ， 你 就 可 以 选择 重新 构建 哪个 (依赖 的 ) target 了。 在 这 个 例子 中 ， 单 击 项 目 叶 航 器 顶端 
的 选项 ， 打 开 passer-rating target 的 Target 编 辑 器 ， 展 开 Target Dependencies 阶 段 。 单 击 + 按 钮 选择 passef 这 个 tafget， 将 它 添加 到 依赖 
列表 中 。 


若 要 删除 它 ， 就 回 到 Scheme 编 辑 器 中 ， 然 后 再 次 启用 隐 式 依赖 。 如 果 不 这 么 做 ， 之 后 你 会 有 麻烦 。 


6.3.2 ”调试 依赖 target 


还 有 一 点 ， 假 设 你 在 libpasser.a 中 开 友 了 一 个 新 图 数 ， 想 要 人 在 命 令 行 工 具 调 用 它 的 时 候 进 行 调试 。 工 具 与 新 编写 的 函数 由 不 
同 的 target 创 建生 成 。 这 样 会 有 问题 吗 ? 


你 可 以 目 己 尝 试 下 : 在 给 completionComponent 赋 值 的 地 万 设 置 一 个 断 点 ， 然 后 运行 passer-rating。 


果然 ， 应 用 程序 在 断 点 处 停 了 下 来 。 当 进入 当前 的 可 执行 程序 时 ，Xcode 会 整理 跨 target 的 调试 信息 。 


6.4 小 结 


现在 ,你 已 经 将 pass-rating 这 个 应 用 程序 分 为 了 主 程序 和 一 个 静态 库 文件 。 本 来 并 不 值得 这 样 做 ,但 这 只 是 一 个 例子 。 


在 这 个 过 程 中 ， 你 创建 了 一 个 target， 收 集 并 构建 了 新 库 所 需要 的 文件 ， 并 且 在 库 文 件 和 主 程序 间 分 友 文 件 。 将 libpasser.a 
库 产 品 添加 a 到 了 主 程序 passer-rating 的 target 中 。 


你 也 了 解 了 Xcode 在 两 方面 做 得 非常 出 色 : 当 把 一 个 库 文 件 添加 到 应 用 程序 的 target 中 的 时 候 ， 并 不 仅仅 是 将 这 个 库 文 件 链 
接 到 了 应 用 程序 中 ， 而 且 还 确保 了 构建 应 用 程序 的 时 候 ， 使 用 的 是 这 个 库 文 件 的 最 新 版 本 。 同 时 ， 主 程序 与 库 文 件 之 间 共 享 调试 
信息 ， 这 样 束 能 在 应 用 程序 运行 的 过 程 中 检查 库 文件 的 功能 是 否 正常 。 


下 一 章 将 会 介绍 一 些 关于 代码 管理 的 内 容 。 


第 / 章 ”版 本 控制 


对 于 项 目 passer-rating 来 说， 规模 并 不 大 一 一 源 文件 还 不 到 100 行 ， 再 加 上 项 目 文件 的 内 容 一 一 但 是 你 已 经 在 这 上 面 花 费 
了 不 少 心思 ， 也 直到 了 不 少 问 题 。 到 现在 为 止 ， 你 仅仅 创建 了 3 个 文件 ， 现 在 的 操作 是 创建 文件 ， 之 后 丈 会 对 这 些 文件 进行 修 
改 。 如 果 和 大 多 数 程序 员 一 样 ， 你 对 代码 的 态度 融会 很 保守 。 之 前 的 阔 数 可 能 不 再 需要 了 ， 但 是 这 个 函数 可 能 还 在 文件 中 ， 融 会 


造成 潜在 的 问题 。 





有 一 个 方法 可 以 简单 地 将 不 用 的 代码 保留 在 正在 使 用 的 源 文件 中 ， 那 束 是 将 其 作为 注释 或 者 将 其 放 入 #if 0 语句 块 中 。 但 这 
样 做 会 让 源 文件 变 得 元 余 ， 并 且 计 代码 变 得 隆 汲 难 懂 。 一 旦 版 本 逐渐 增长 ， 束 很 难 追 路 到 这 些 代码 块 属于 哪 一 个 钦 辑 。 


源 文件 控制 系统 (或 者 说 版 本 控制 系统 ) 是 一 个 追踪 项 目 全 部 文件 的 数据 库 ， 它 能 在 你 工作 的 过 程 中 记录 文件 的 更 改 。 版 本 
控制 系统 将 你 从 更 改 大 量 文件 可 能 引 友 的 安全 问题 中 解放 出 来 ， 如 果 需 要 回 退 所 做 的 更 改 ， 那 么 每 一 个 文件 之 前 的 版 本 都 能 使 
FA. 


CARA RETA RAE, BiFSARAZAMMFNABIMEARERZIC. BY, BIA NAR SALTS 
库 非 常 轻松 ， 而 且 对 协调 大 型 团队 的 工作 也 很 有 帮助 。 但 是 如 果 你 独自 工作 : 


你 可 能 仍然 会 在 源 代码 中 做 大 量 修改 。 


->z 
> 


可 能 仍然 需要 参考 之 前 的 版 本 。 

` 你 可 能 仍然 需要 回 退 到 之 前 的 版 本 ， 让 自己 从 之 前 挖 的 “ 坑 PHAR. 

- 你 会 发 现 使 用 版 本 控制 会 让 代码 变 得 更 整洁 ， 而 不 是 尝试 将 所 有 废弃 的 代码 都 注释 挤 或 者 放 入 #if 0 语句 块 中 。 
“ 你 可 能 需要 在 多 台 计 算 机 上 工作 ， 每 台 计 算 机 会 对 代码 仓库 做 不 同 的 更 改 。 


正如 我 在 第 3 章 中 所 说 的 那样 ， 如 果 你 打算 更 改 代码 一 一 如 果 需 要 多 次 保存 文件 一 一 那么 最 好 将 这 个 文件 放 到 版 本 控制 器 


中 。Xcode 6 让 这 一 点 变 得 十 分 简单 。 


wit Xcode 6 支持 两 种 版 本 控制 系统 : Subvetsion 和 Git。Subvetsion 的 使 用 非常 广泛 ， 但 是 它 正 逐渐 被 分 布 式 的 版 本 管理 
系统 如 Git 取 代 。 大 多 数 开源 项 目 都 会 通过 GitHub 这 样 的 公共 服务 或 者 通过 网 络 上 的 私人 代码 仓库 进行 共享 。 从 Xcode 4 
起 ，Xcode 的 工作 流 就 开始 以 Git 为 中 心 。 为 简单 起 见 ， 本 书 我 仅 会 介绍 Git， 对 此 我 很 抱歉 。 


7.1 SRAM 


我 已 经 说服 你 使 用 版 本 控制 ， 你 想 让 项 目 处 于 版 本 控制 之 下 。 那 么 如 何 开始 ? 


如 果 你 在 第 3 章 采 纳 了 我 的 意见 ， 那 么 现在 你 已 经 在 使 用 版 本 控制 了 。 当 在 磁盘 上 创建 一 个 新 项 目的 时 候 ， 会 出 现 一 个 复 选 
框 ，Create git repository on， 默 认 选 择 的 是 My Mac， 见 图 7.1。 义 选 这 个 复 选 框 。passer-rating 这 个 文件 夹 包 含 一 个 隐藏 
的 .git/ 目 录 ， 这 个 目录 中 存放 着 项 目的 索引 ，Xcode 会 跟踪 你 添加 和 编辑 的 文件 。 


Source Control: [) Create Git repository on My Mac 


de Will pace Your project Under version cantra i 


Add to: Don't add to any project or workspece 


New Folder Cance| 





A7.1 ” 当 创 建 一 个 项 目的 时 候 ，Xcode 会 创建 一 个 本 地 Git 仓 库 用 于 版 本 管理 


如 果 你 用 过 欢迎 窗口 (Window 一 Welcome to Xcode, 41) ， 你 可 能 已 经 选择 了 Check out an existing project, © 
能 引导 你 将 一 个 远程 代码 仓库 克隆 到 本 地 。 克 隆 的 过 程 中 会 创建 一 个 .git 文 件 夹 ， 这 份 代码 将 会 处 于 本 地 仓库 管理 的 控制 之 下 。 


还 有 第 三 种 选择 。 如 果 你 在 偏好 窗口 中 的 Accounts 选 项 卡 内 注册 了 Xcode 服务 器 ， 那 么 Create git repository on 的 弹出 菜 
单 中 将 会 包含 服务 器 的 名 称 。 若 选择 这 个 服务 器 ，Xcode 将 会 在 项 目 文件 夹 下 为 本 地 代码 仓库 创建 一 个 .git 目 录 ， 但 是 它 也 会 与 
服务 器 沟通 ， 在 服务 器 上 创建 一 个 远程 代码 仓库 。 其 他 开 友 者 (或 者 其 他 计算 机 ) 残 能 用 同一 份 项 目 代 码 协 同 工 作 开 妈 。 


心 注意 Xcode Setvet 是 Yosemite Servet 的 一 个 功能 。 服 务 器 管理 程序 包含 一 个 Xcode 使 用 的 配置 面板 ， 与 在 邮件 或 者 网 页 中 
操作 的 面板 一 样 。YosemiteServer 是 一 个 简单 的 插件 (早期 版 本 的 OS 义 Server 是 零售 OS 昂 员 的 替代 品 ) ， 在 Mac 应 用 商店 中 售 价 
约 为 50 美 元 。 作 为 Mac Developer Program 的 付费 开发 者 ， 你 能 免费 下 载 当前 版 本 。 


手动 创建 一 个 Git 版 本 库 


绝 大 多 数 情 况 下 ， 你 都 会 使 用 目 动 创建 或 者 将 远程 代码 库 取 回 本 地 的 方法 ， 完 全 不 用 操心 中 间 过 程 。 不 过 ， 你 必须 清楚 如 何 
将 一 个 已 经 存在 的 项 目 纳入 版 本 管理 系统 中 。 


我 推荐 一 个 可 选 的 操作 : 创建 一 个 .gitignore 文 件 ， 告 知 Git 特 定 的 文件 和 目录 排除 在 版 本 控制 的 范围 之 外 ， 这 些 文件 不 必 纳 
入 版 本 控制 汉 围 乙 内 ， 以 防止 代码 仓库 膨胀 。 同 时 ， 这 些 文 件 也 不 会 出 现 版 本 党 理 的 状态 消息 。 做 法 很 简单 。 打 开 Terminal 应 
用 程序 (/Applications/Utilities/Terminal) ， 然 后 输入 : 


# Focus on the project's directory: 
cd /path/to/my/project 


# Enter the contents of the file, closing with control-D 
cat > .gitignore xcuserdata/ .DS_Store AD 

# Want to add other files? 

# Include them in that last command, 

# or append them to the existing .gitignore 

# with "cat >> .gitignore" (two carets). 
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DEB ”Apple 的 Git 版 本 本 身 就 知道 部 分 需要 忽略 的 文件 和 目录 。 


Xcode 6 和 Yosemite 在 命令 行 开发 工具 如 Git 中 采取 了 一 些小 技巧 。 见 第 1 章 。 


$ # Add a Git repository to this directory: 

E git init 

Initialized empty Git repository in 
/Users/xcodeuser/Desktop/MyProject/.git/ 


# Tell Git you want to control everything in "." (this 
# directory tree), except for what's in .gitignore: 
git add . 


# Tell Git to record the files you added, 
# logging it as "Initial commit" 


$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 


git commit -m ‘Initial commit' 

[master (root-commit) f0d59bf] Initial commit 
9 files changed, 819 insertions (+) 

create mode 100644 .gitignore 


这 就 是 你 需要 做 的 工作 ， 也 是 Git 关 心 的 内 容 。 但 是 ， 这 些 操作 如 果 是 你 在 项 目 打 开 的 情况 下 操作 的 ， 那 么 Xcode 并 不 会 及 
时 更 新 文件 状态 。 在 Source Control 菜 单 能 辨认 出 你 的 项 目 之 前 ， 需 要 退出 Xcode 并 重新 启动 ， 这 样 源 代 码 管理 (source- 
control) 的 状态 标识 才 会 出 现在 项 目 导航 器 中 。 


Git 在 它 追 踪 的 文件 上 附加 了 部 分 元 信息 ， 一 行 行 地 记录 了 文件 修改 者 的 名 字 和 邮件 地 址 。 当 你 第 一 次 尝试 向 Git 中 提交 文件 
的 时 候 ， 如 果 没 有 配置 名 称 和 邮件 地 址 ，Git 将 会 停止 提交 操作 直到 你 进行 了 相关 设置 。 它 将 给 出 可 能 会 用 到 的 命令 的 例子 。 


如 果 你 使 用 的 第 一 个 代码 仓库 是 由 Xcode 创建 的 ， 那 将 会 遇 到 一 个 问题 。 对 于 一 个 新 项 目 ，Xcode 首 先 要 做 的 是 提交 几乎 所 
有 由 项 目 模板 创建 的 文件 。 如 果 没 有 设置 Git 身 份 验证 信息 ， 那 么 这 次 提交 将 会 失败 。Xcode 会 在 一 个 警告 界面 中 显示 出 Git 的 提 
示 信 息 ， 提 交 操 作 也 会 到 此 为 止 。 你 需要 在 Terminal 中 解决 这 个 问题 。 


# Focus on the project directory (use your own path) 
cd /path/to/my/project 


# Set your metadata (your own address and name) 
git config --global user.email "xcodeuser@example.com" 


git config --global user.name "Xcode User" 


# Do the commit Xcode couldn't 
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git commit -m ‘Initial commit' 


Oe 如 果 之 前 就 有 本 地 代码 人 仓库， 那么 你 也 可 以 将 本 地 代码 仓库 与 远程 仓库 相连 。 见 本 章 后 面 的 7.4 节 。 


7.2 ”文件 状态 

Xcode 展示 了 一 个 源 代码 控制 模型 ， 它 很 接近 你 选择 的 版 本 控制 系统 。Subversion 和 和 Git 不 同 。 我 将 会 向 你 展示 Git 如 何 处 理 
文件 ， 以 及 Xcode 如 何 呈 现 这 些 文件 。 

在 Git 中 ， 一 个 文件 有 6 种 状态 : 


.Ignored。 文 件 名 与 .gitignore 文 件 中 的 文本 模式 相 匹 配 。Git 永 远 都 不 会 将 这 类 文件 纳入 版 本 管理 系统 ， 除 非 你 显 式 地 将 这 
些 文件 添加 到 版 本 库 中 。 


- Untracked。 Git 知 道 这 个 文件 的 存在 ,但 是 这 个 文件 既 没 有 在 版 本 库 中 ， 也 没有 添加 到 版 本 库 的 缓存 中 。Git 中 没有 它 之 前 
的 版 本 。 使 用 git add 命 令 可 以 将 它 加 入 版 本 库 的 暂 存 区 (stage) 。 


Modified。 从 茶 种 意义 上 讲 ， 修 改过 的 文件 与 Unttacked 的 文件 差不多 : 在 它 被 纳入 暂 存 区 之 前 ， 文 件 内 容 不 会 添加 到 版 本 
库 中 。 不 过 ， 它 之 前 的 版 本 都 在 版 本 库 中 ， 而 且 可 以 和 当前 的 版 本 进行 对 比 ， 或 者 将 当前 版 本 恢复 为 历史 版 本 。 同 时 ， 这 类 文件 
也 可 以 使 用 git add 命 令 添 加 到 版 本 库 中 。 


"Staged。 这 个 文件 已 经 被 指定 (使 用 gitadd 命 令 ) 为 下 次 提交 时 要 包含 的 文件 。 为 什么 add 命 令 不 简单 地 将 修改 过 的 文件 或 
者 新 文件 添加 到 版 本 库 中 ? 因为 在 项 目 中 做 逻辑 修改 的 时 候 通常 会 涉及 多 个 文件 ， 比 如 .m 文 件 中 有 一 个 方法 ， 它 定义 在 一 个 头 文 
件 中 ， 其 他 .m 文 件 会 使 用 这 个 方法 。 如 果 仅 提交 或 者 回 退 部 分 更 改 肯 定 不 合理 。 当 你 将 一 个 文件 放 入 暂 存 区 的 时 候 ， 从 概念 上 说 


就 是 将 它 放 入 了 一 个 文件 组 中 ， 这 些 文件 会 一 次 性 提交 到 代码 仓库 中 。 


-Unmetged。 当 你 对 文件 做 了 更 改 ， 同 时 又 从 另外 一 个 版 本 库 中 取 回 这 个 文件 的 时 候 ， 如 这 两 个 文件 的 更 改 有 冲突 ， 那 么 
这 个 文件 就 处 于 Unmerged 的 状态 。Git 会 高 充 显 示 冲 突 文 件 ， 并 且 会 在 没 解决 冲突 就 想 要 提交 的 时 候 发 出 警告 。 当 你 做 出 修改 并 


将 文件 重新 放 入 暂 存 区 后 ，Git 会 将 这 个 文件 标记 为 已 经 解决 ， 不 再 报错 。 


Unmodified 这 是 使 用 git commit 命 令 后 ， 当 前 文件 的 状态 ， 此 时 这 个 文件 已 经 在 版 本 库 中 了 。 现 在 这 个 文件 与 Git 没 有 什么 
关系 ， 除 非 你 想 要 查看 或 者 将 这 个 文件 恢复 为 早期 版 本 。 当 修改 并 保存 了 这 个 文件 后 ， 这 个 文件 就 会 变 为 Modified 的 状态 ， 然 后 
又 开始 新 一 轮 的 add/commit 和 循环 。 


如 果 删 除 一 个 文件 ， 那 么 它 会 被 视 为 修改 过 的 文件 。git rm 命令 会 将 这 个 文件 从 版 本 库 中 删除 。 如 果 移 动 一 个 文件 或 者 将 一 
个 文件 重 命名 ， 那 么 也 相当 于 在 原先 的 位 置 对 该 文件 执行 了 git rm 命令 ， 同 时 对 新 文件 执行 git add 命 令 。 命 令 git mv 会 将 这 两 
个 操作 合 二 为 一 。 当 你 这 么 做 的 时 候 ，Git 会 知道 “ 旧 ” 文 件 和 “新 ”文件 相同 ， 文 件 的 历史 记录 也 不 会 遭 到 破坏 。 


Xcode 如 何 与 Git 协 同 工 作 


Xcode 中 的 Git 版 本 库 稍 微 有 所 不 一 样 ， 因 为 Xcode 作为 一 款 IDE， 它 需要 另外 一 层 抽 象 。Xcode 在 显示 Git 管 理 的 文件 时 ， 
文件 有 6 种 状态 : 


- Unmodified。 项 目 导 航 器 中 的 文件 没有 任何 标识 。 文 件 的 历史 版 本 保存 在 版 本 库 中 ， 现 在 没有 任何 修改 需要 添加 到 版 本 库 


- Modified。 项 目 导 航 器 中 的 文件 有 一 个 M 标 识 。 这 个 文件 处 于 版 本 库 中 ,但 是 自从 你 上 次 提交 之 后 ， 又 修改 过 这 个 文件 。 
Git 将 这 些 文件 视 为 modified， 而 不 是 staged。Xcode 的 版 本 管理 模型 中 没有 staged 这 个 状态 。 当 你 提交 一 个 版 本 的 时 候 ，Xcode 会 让 


你 选择 这 次 提交 都 会 包含 哪些 文件 ， 然 后 将 这 些 文件 暂 存 并 提交 。 


- Added。 文 件 名 后 面 有 一 个 A 标识 。 如 果 你 在 项 目 中 创建 了 一 个 新 文件 
(File+New—Filehttp://www.hzcourse.com/resoutce /teadBook? 
path= /opentresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., dN) ， 或 者 添加 了 一 个 已 经 存在 的 文件 并 将 它 复制 到 
了 项 目 目录 中 (File—>Add Files tohttp://www.hzcourse.com/tresoutce/readBook? 
path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., CHA) ，Xcode 会 将 这 些 文件 添加 到 暂 存 区 ,但 是 


Xcode 仍然 允许 你 在 执行 提交 操作 的 时 候 ， 将 这 些 文件 排除 在 提交 操作 之 外 。 


. Renamed。 文 件 名 后 面 有 一 个 A+ 标 记 。 这 个 状态 说 明 你 在 项 目 中 移动 或 者 重 命名 了 一 个 文件 。Xcode 会 暂 存 这 些 文件 ， 但 


是 仍然 允许 你 在 执行 提交 操作 的 时 候 ， 将 这 些 文 件 排 除 在 提交 操作 之 外 。 


- Conflicted。 有 一 个 红色 的 C 会 添加 在 任何 其 他 状态 标识 符 之 前 。 当 你 从 其 他 版 本 库 中 将 更 改 的 代码 合并 你 本 地 版 本 库 的 时 
候 ， 它 可 能 无 法 决定 合并 的 过 程 中 应 该 保留 哪个 文件 中 的 哪些 行 一 一 后 面 会 详细 介绍 这 个 问题 。Xcode 用 C 符 号 标记 这 类 文件 ， 


在 你 没有 使 用 Source Control—Mark Selected Files as Resolved 命 令 解 决 这 些 冲 突 之 前 ，Xcode 将 会 拒绝 执行 提交 操作 。Git 对 这 类 文 


件 的 处 理 方法 有 些 不 同 : 它 会 记录 冲突 文件 ， 但 是 会 在 你 编辑 并 将 这 些 文件 暂 存 的 时 候 清理 这 些 冲 突 。 
- 详情 见 7.5 节 ， 其 中 会 介绍 如 何 解决 文件 中 的 冲突 问题 。 


- Unknown。 使 用 ? 标记 。 这 类 文件 处 于 项 目 文件 夹 中 ， 但 是 不 在 代码 仓库 中 。 这 个 状态 等 同 于 Git 中 的 Unhttracked 状 态 。 


7.3 ”首次 提交 

如 果 你 在 创建 项 目的 同时 创建 了 Git 版 本 库 ，Xcode 残 已 经 完成 了 第 一 次 提交 操作 ， 所 有 的 源 代码 文件 ， 以 及 所 有 并 非 是 个 
人 拥有 的 配置 文件 都 已 经 提交 到 了 版 本 库 中 。 

但 是 第 一 次 提交 你 都 做 了 什么 ?让 我 们 尝试 一 下 : 

1) 如 果 在 创建 项 目 passer-rating 的 时 候 没 有 创建 版 本 库 ， 那 么 请 使 用 我 教 你 的 万 法 创建 一 个 。 

2) 打开 项 目 passer-rating。 


3) 如 果 现 在 刚刚 创建 了 本 地 版 本 库 (可 能 需要 重启 Xcode) ， 项 目 导 航 器 中 的 文件 都 会 被 标记 为 M。 人 否则 ， 对 其 中 的 一 个 
文件 进行 更 改 并 保存 ， 这 个 文件 过 一 会 束 会 被 标记 为 M。 


4) 选择 Source Control—>Commithttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (LEC) 命令 。 会 出 现 一 个 显示 更 改 内 容 并 提 
供用 于 记录 更 改 内 容 的 文本 编辑 界面 ， 见 图 7.2。 


Pinuar- rating lik) rating h 
v (0 passer-rating 10 #define passer_rating_rating_h 


[h] 11 rating. n 


12) fee Calculate the NFL/CFL rating from a passer’s k 3 /f passer—-rating 
r i fj 


performance. i fi 
13 q s/f Created by Fritz Anderson on 7/5/14. 
i+ The statistic may validly be computed from the $ /f Copyright (c) 2814 Fritz Anderson. AlL rights 
record of any span of time: A quarter, a game, 1 reserved, 
ā season, 4 career. q 7 fi 


aparam comps Passes completed in the span 4 9 #ifndef passer_rating_rating_h 
aparam atts Number of attempts to make a pass k 10 #define passer_rating_rating_h 
aparam yds Total yards gained from passes | 1 
@param tds Touchdowns resulting from passes - = L Tloat passer_rating(int comps, int atts, int yds, 
param ints Interceptions resulting from passes j 13 int tds, int ints): 
' is #endif 
Breturn A Float representing the calculated passer a5 
rating 


@bug The calculation is incorrect. 
F] 
| 3? float passer_ratinglint comps, int atts, int yds, 
i: int tds, int ints}; 
[E passer-rating } Y master } (©) Local Revision i H E p...ing) Y master } (D 74214 Fritz Anderson af64fe4bMf5 (BASE, HEAD) 
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示 了 每 个 文件 的 更 改 。 窗 


图 7.2 ”对 比 编辑 器 (Comparison editor) 的 提交 编辑 器 (Commit editor) 界面 中 有 一 个 变量 ， 它 高 沈 显 示 
区 域 用 于 显示 新 版 本 的 信 


口 左边 的 源 代码 列表 允许 你 取消 选择 某 个 不 想 提交 的 文件 。 将 要 提交 的 文件 仍然 可 以 编辑 。 界 面 下 方 的 
息 。Xcode 在 执行 提交 操作 的 时 候 不 允许 省 略 注释 文本 


` 


Oss 提交 编辑 器 (Commit editor) 用 于 显示 正在 提交 的 文件 所 做 的 更 改 ， 这 是 一 个 货真价实 的 编辑 器 。 你 可 以 在 这 个 


编辑 器 中 做 最 后 的 修改 ， 这 些 修 改 也 会 成 为 提交 的 一 部 分 。 


7A 使 用 远程 版 本 库 


Git 是 一 个 分 布 式 的 源 代码 管理 系统 。 人 简单 地 癌 ， 每 位 开 友 者 都 拥有 包含 项 目 全 部 历史 记录 的 版 本 库 。 这 些 版 本 库 都 是 点 对 
点 的 关系 ， 原 则 上 来 讲 ,， 没 有 一 个 版 本 库 拥有 绝对 的 控制 权 。Subversion 中 有 一 个 独立 的 版 本 库 ， 所 有 的 客户 端 都 会 以 这 个 版 
本 库 为 准 ， 下 载 代码 镜像 ，Git 并 没有 继承 这 个 概念 。 


不 过 ， 对 于 项 目 来 说 通常 会 有 这 样 一 个 中 央 版 本 库 ， 这 个 版 本 库 始终 可 用 。 它 作为 项 目的 备份 ， 有 一 个 固定 的 IP 地 址 和 主机 
名 。 这 样 ， 多 个 开发 者 或 者 在 不 同 计算 机 上 工作 的 同一 个 开 友 者 ， 丈 可 以 随时 保持 同步 。 


通常 会 有 一 些 裸 (“bare”) 版 本 库 ， 这 类 代码 仓库 在 使 用 clone 或 者 init 命 令 创建 时 会 带 --bare 参 数 ， 这 样 它们 就 不 会 包 
含 开 发 者 在 项 目 中 使 用 的 文件 。 


StS 本 地 项 目 可 能 与 多 个 远程 代码 仓库 相连 ， 但 是 我 们 从 简 考 虑 。 
Xcode 中 有 3 种 方法 处 理 远 程 版 本 库 。 


复制 一 个 已 经 存在 的 代码 仓库 : 已 知 远 程 代 码 仓 库 的 存在 ， 你 可 以 在 Welcome 窗 口中 选择 Check out an existing project (TH 
1) o Source Control—Check outhttp://www.hzcoutse.com/tesoutce/teadBook? 
path=/opentesources/teach_ebook/uncompressed/15555/OEBPS/Text/... 命 令 具 有 相同 的 效果 。 很 明显 ， 远 程 仓库 已 经 存在 于 那 
里 ， 否 则 你 也 无 法 复制 它 。 


: 使 用 Xcode 服务 器 创建 一 个 代码 仓库 : 如 果 没 有 远程 服务 器 ， 使 用 Xcode 可 以 创建 一 个 。 如 果 你 在 Preferences 窗 口 的 
Accounts 标 签 栏 下 面 注册 了 Xcode 服务 器 。 那 么 你 可 以 让 服务 器 为 你 创建 一 个 裸 版 本 库 。 如 果 在 工作 目录 中 有 一 个 本 地 的 代码 仓 
库 ， 那 么 可 以 在 Source Control 菜 单 中 选中 工作 目录 ， 然 后 选择 Configurehttp://www.hzcourse.com/resoutce/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/...， 就 会 出 现 Configure Repository 界 面 ， 选 择 中 间 的 选项 卡 


Remotes。 


单 击 左 下 方 的 + 按钮 ， 然 后 选择 Create New Remotehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...。Xcode 服 务 器 会 要 求 验证 你 的 注册 信息 ， 然 后 
为 本 地 引用 起 一 个 名 字 (这 个 名 字 必 须 得 合 Git 工 具 的 使 用 规 学 ，Xcode 将 会 拒绝 不 符合 要 求 的 名 字 ) ， 见 图 7.3 上 右 。 


使 用 Xcode 登录 Xcode Server， 请 求 创建 代码 仓库 ， 服 务 器 将 会 完成 剩 下 的 工作 。 将 你 本 地 的 工作 内 容 推送 到 远程 服务 器 
(Source Control—Pushhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 然 后 选择 远程 服务 器 和 分 支 ) 。 这 样 要 进行 的 
操作 就 已 经 完成 。 在 服务 器 上 ， 服 务 器 管理 应 用 程序 的 Xcode 面板 就 会 显示 出 新 的 版 本 库 ( 见 图 7.4) 。 


` 添加 对 已 有 代码 仓库 的 引用 : 在 配置 版 本 库 (Configure Repository) 编辑 器 中 单 击 + 按钮 ， 选 择 Add Remote 选 项 就 会 出 现 
一 个 对 话 框 界面 ， 要 求 填 入 本 地 文件 夹 名 和 远程 仓库 的 URL， 见 图 7.3 上 右 。Xcode 将 会 把 本 地 的 工作 目录 的 配置 替换 成 远程 服务 
器 的 配置 。 当 你 想 要 从 远程 服务 器 拉 取 或 者 推送 代码 的 时 候 ，Xcode 将 会 显示 远程 版 本 库 及 其 分 支 。 


Add Remotehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 与 命令 行 中 的 git remote add 命 令 基本 上 具有 相 
同 的 功能 。 这 条 命令 说 明 它 只 是 一 个 本 地 版 本 库 ， 指 同一 个 远程 版 本 库 。 在 Xcode 中 创建 这 个 引用 并 不 能 确保 远程 服务 器 存在 这 
个 版 本 库 或 者 这 个 版 本 库 可 用 。 


Add a Remote: Select a server to create a remote on: 


Name: fort-knox Server: manoverboard 





Address: 'ssh://fort-knox.example.com/git/passer-rating. git Remote Name: origin 


Cancel! Add Remote Cancel Create 





Configure passer-rating: 


Remotes Branches 


[=r origin 
ssh-//fritza@manoverboard-2.local/git/passer-rating.git 








图 7.3 ”使 用 Soutce Control $ -Æ P #9 Configure Repository Rw (F) ， 你 可 以 添加 一 个 已 经 存在 的 版 本 库 作 为 远程 版 本 库 (上 
左 ) ， 也 可 以 使 用 Xcode 创建 一 个 全 新 的 版 本 库 (EA) 


© D 
Servar 


=) manoverboard 


< Alerts F 
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E too: 
@ Stats Access 
Accounts Repositories can be accessed over HTTPS and SSH 


Users : 
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加 Time Machine 
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人 FTP 
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图 Open Directory 
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图 7.4 ”从 Xcode 中 将 一 个 版 本 库 添 加 到 Xcode 服 务 器 中 ， 就 会 将 这 个 新 的 版 本 库 添 加 到 服务 器 的 管理 应 用 程序 列表 中 


7.4.1 本 地 建立 一 个 “远程 ”版 本 库 


你 不 用 想象 企 一 个 特定 的 远程 版 本 库 上 工作 ， 甚 至 都 不 需要 另外 一 台 机 器 。 使 用 本 章 介绍 的 方法 ， 你 可 以 使 用 本 地 的 文件 目 
录 完 成 任何 需要 在 远程 服务 器 上 完成 的 工作 。 


你 需要 在 /Users/Shared 文 件 夹 中 创建 一 个 “ 裸 ” (没有 工作 文件 ) 版 本 库 ， 将 其 标注 为 “共享 (shared) ” ， 意 思 是 说 所 
有 的 用 户 都 能 访问 它 。 打 开 Terminal， 执 行 以 下 命令 : 


# Work on the "Shared" user 
cd /Users/Shared 


# Create a directory for Git repositories... 
mkdir git 


cd git 


$ 

$ 

$ 

$ 

$ 

$ 

$ # ... and work on that 
$ 

$ 

$ # Create a shareable, bare repository named passer-rating.git 

$ git init --bare --share=all passer-rating.git 

Initialized empty Git repository in /Users/Shared/git/passer-rating.git/ 
$ 

$ # The directory contains just the repository infrastructure 

$ Is -l passer-rating.git/ 


total 24 

-rw-rw-r-- 1 fritza staff 23 Jul 7 15:56 HEAD 
drwxrwsr-xX 2 fritza staff 68 Jul 7 15:56 branches 
-rw-rw-r-- 1 E~ritza staff 171 Jul 7 15:56 config 
-rw-rw-r-- 1 fritza staff 73 Jul 7 15:56 description 
drwxrwsr-x 11 fritza staff 374 Jul 7 15:56 hooks 
drwxrwsr-xX 3 fritza statt 102 Jul 7 15<S6: into 
drwxrwsr-xX 4 fritza staff 136 Jul 7 15:56 objects 
drwxrwsr-x 4 fritza staff 136 Jul 7 15:56 refs 

$ 


这 样 ，/Users 人 /Shared/git/ 目 录 中 就 包含 了 一 个 名 为 passer-rating.git 的 版 本 库 。 之 所 以 称 它 为 “ 裸 ” 代 码 仓库 ， 是 因为 它 
没有 包含 任何 可 以 编辑 或 者 提交 文件 的 工作 目录 ， 而 且 以 后 也 永远 都 不 会 有 。 这 个 代码 仓库 存在 的 唯一 目的 就 是 保留 其 他 客户 端 
的 工作 。--shared 标 识 用 于 通知 Git: 每 当 这 个 版 本 库 发 生变 化 的 时 候 ， 它 们 应 当 给 予 保留 其 他 用 户 访问 这 个 版 本 库 的 文件 系统 
权限 。 


回 到 Xcode 中 的 项 目 passer-rating， 在 Source Control 菜 单 中 选中 本 地 的 代码 仓库 和 分 支 ， 然 后 选择 Configure passer- 
rating... (或 者 任何 你 自己 本 地 起 的 名 字 ) 。Configure Remote 编 辑 器 与 本 章 前 面 我 所 展示 的 那个 一 样 。 在 Remotes 选 项 卡 
中 ， 音 击 + 弹 出 菜单 ， 选 择 Add Remotehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 将 远程 版 本 库 命名 为 origin ( 主 版 本 库 约定 俗 
成 的 名 字 ) ， 然 后 输入 URL 地 址 : file://Users/Shared/git/passer-rating.git。 


现在 ,你 已 经 做 好 了 使 用 origin 版 本 库 的 全 部 准备 ， 之 前 介绍 的 那些 技巧 都 可 以 使 用 ， 而 不 用 关心 版 本 库存 放 的 位 置 。 


全 注 训 读者 可 能 感觉 被 骗 了 ， 因 为 这 个 “远程 (remote) ”版 本 库 并 不 是 在 另外 一 台 机 器 上 。 但 是 在 Git 中 ， “远程 这 
个 术语 并 不 是 这 个 意思 。 远 程 版 本 库 指 的 是 非 本 地 版 本 库 ， 它 并 不 在 乎 这 个 版 本 库 在 哪里 一 一 它 其 至 可 能 在 本 地 账户 的 另外 一 个 
子 目录 中 。 在 偏好 窗口 中 的 Accounts 面 板 中 向 版 本 库 列 表 中 添加 一 项 ， 然 后 输入 一 个 URL 
径 以 及 访问 凭证 。 一 旦 建立 了 这 个 链接 ，Git 就 会 隐藏 远程 服务 器 实际 所 在 的 详细 信息 。 在 撰写 本 
书 的 时 候 ， 我 正在 使 用 Xcode setvet 上 的 一 个 版 本 库 ， 因 为 它 能 满足 工作 流 的 需要 。 同 时 我 也 想 介 绍 一 些 其 他 特性 ， 不 过 你 也 可 
以 使 用 远程 服务 器 上 的 文件 ， 你 会 发 现 没 有 什么 区 别 。 





fle、ssh、http 等 任何 合适 的 地 址 








顺便 说 一 下 ， 什 么 是 Git server? Git 可 以 通过 HTTP 或 者 HTTPS 传 输 文件 ,但 是 对 于 小 团队 来 说 ， 更 常见 的 方法 是 在 一 人 台 运 行 
着 ssh 服 务 器 的 UNIX 机 器 上 安装 Git。 没 有 一 个 名 为 Git server 的 软件 包 。 并 不 是 每 一 个 远程 代码 仓库 都 是 一 个 服务 器 一 一 所 有 的 代 
码 仓 库 都 是 同 级 的 关系 ) MA 外 一 个 开发 者 本 地 的 代码 仓库 中 存 取 代码 完全 可 行 。 本 书 无 法 涵盖 ARZ 多 变 体 。 推荐 阅读 本 章 后 面 


的 完整 指引 以 及 附录 B 中 的 内 容 。 
7.4.2 将 文件 推送 到 远程 服务 器 

全 新 的 裸 版 本 库 没有 任何 内 容 ， 如 果 你 想 从 这 个 空 版 本 库 中 取得 一 份 副本 会 得 到 Git 给 出 的 错误 信息 。 必 须 将 文件 提交 到 服 
务 器 ， 用 这 些 文件 填充 它 的 数据 库 ， 并 用 本 地 的 日 志 作 为 这 些 文 件 的 历史 信息 。 


如 果 用 手动 的 方式 添加 一 个 远程 版 本 库 ， 可 能 你 会 不 确定 远程 版 本 库 是 否 存 在 或 者 是 否 能 够 连接 一 一 但 是 Git 并 不 关心 这 
些 ， 它 不 过 是 一 个 为 了 方便 表示 URL 而 起 的 名 字 。 当 出 现 提 交 对 话 框 的 时 候 ，Xcode 在 填充 remote/branch 弹 出 框 的 时 候 会 短暂 
地 停顿 一 下 。 在 这 段 时 间 内 ，Xcode 会 确定 远程 服务 器 是 否 存 在 并 可 以 连接 。Xcode 不 会 将 无 法 连接 的 版 本 库 地 址 填充 到 弹出 框 
中 。 如 图 7.5 所 示 。 


Push local changes: 


Y origin/master 


Cancel 





图 7.5 ”选择 Source Control—Pushhttp://www.hzcoutse.com/resoutce/teadBook? 
path=/opentesoutces/teach_ebook/uncomptressed/15555/OEBPSVText/…， 会 弹出 一 个 对 话 框 ， 里 面 明 确 给 出 了 你 所 能 选择 的 远程 
服务 器 ， 以 及 你 想 要 提交 到 的 远程 服务 器 中 的 分 支 。 如 果 你 本 地 有 一 个 分 支 ， 而 远程 服务 器 没有 ， 那 么 弹出 菜单 中 就 会 包含 在 远 
程 服务 器 上 创建 分 支 的 选项 


单 击 Push 按 钮 ， 在 代码 提交 到 远程 服务 器 的 过 程 中 ， 对 话 框 会 显示 一 个 旋转 的 图 标 。 当 提交 操作 完毕 后 ， 会 出 现 一 个 绿色 
的 对 勾 ， 同 时 这 个 界面 也 会 消失 。 


15 ”合并 与 冲突 


到 现在 为 止 ， 所 有 的 工作 都 是 在 Mac 上 同一 个 账户 下 进行 的 操作 ， 我 们 称 这 个 账户 是 User A。 假 设 User ASUser B 协 同 工 
作 。 为 了 简单 起 见 ， 我 们 认为 User B 是 使 用 同一 侣 Mac 的 另外 一 个 账 尸 。 在 实际 使 用 中 ， 协 作者 可 能 是 其 他 人 一 一 或 者 是 你 目 
己 一 一 用 另外 一 台电 脑 登 录 。 





User B 并 没有 passer-rating 项 目的 副本 ， 但 是 我 们 已 经 知道 得 到 这 样 一 个 副本 很 简单 : 
- 打开 Welcome to Xcode 窗口 (î 361 ) ， 然 后 选择 Check out an existing projecto 


` 或 者 选择 Source Conttol 一 Check outhttp://www.hzcoutse.com/resource /teadBook? 


path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.... 


Xcode 会 在 显示 窗口 中 列 出 已 知 的 版 本 库 ， 以 及 其 他 版 本 库 对 应 的 URL 文 本 框 。Xcode 已 经 知道 一 些 版 本 库 ， 这 是 因为 你 曾 
经 在 Account 面 板 下 的 偏好 窗口 中 注册 过 这 些 版 本 库 。 当 然 ， 它 也 知道 你 添加 a 到 其 他 项 目 中 的 远程 版 本 库 。 


但 是 User B 对 此 一 无 所 知 。 她 需要 输入 版 本 库 的 地 址 ， 然 后 单 击 Next 按 钮 。 在 访问 远程 版 本 库 的 时 候 ， 签 出 窗口 会 显示 一 
个 进度 条 ， 之 后 会 弹出 一 个 保存 文件 的 界面 ， 让 她 选择 项 目 文 件 夹 的 存放 目录 。 

9S 注意 ”可 能 会 弹出 一 个 窗口 告诉 User B， 她 输入 的 URL 指 向 的 位 置 并 不 是 一 个 Git 版 本 库 ， 也 就 是 说 输入 的 这 个 URL 地 址 
毫 无 意义 。 错 误 的 原因 可 能 是 无 效 赁 证、 远程 服务 器 无 法 连接 或 者 URL 不 正确 等 ， 不 过 通常 的 解释 是 说 这 是 个 一 个 无 效 链接 。 咨 


询 提 供 URL 地 址 的 人 ， 查 看 Git 教 程 ， 明 确 Git 接 受 什么 格式 的 URL 地 址 。 


这 样 ，User B 就 获得 了 一 份 passer-rating 项 目 主 干 的 完整 副本 ， 包 括 版 本 历史 记录 。 链 接 到 本 地 版 本 库 的 远程 版 本 库 会 作 
为 origin， 上 默认 情况 下 push 和 pull 操 作 都 会 在 这 个 origin 上 进行 。 


7.5.1 UserA 


User A 对 代码 风格 有 非常 明确 的 想 ; 去 。 他 尤其 不 喜欢 rating.c 文 件 中 的 变量 使 用 很 长 的 定义 。 他 想 要 查找 所 有 Component 
并 将 其 全 部 著 换 为 Comp。 


1. 更 改 : 全 文 蔡 换 


在 菜单 中 选择 Find 一 Findhttp://www.hzcourse.Comy/resource/readBook” 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (¢6F) ， 然 后 在 编辑 器 搜索 文本 框 中 输入 
Component。 随 着 用 户 的 输入 ， 编 辑 器 会 将 相 匹 配 的 文本 高 亮 显 示 。 单 击 搜索 框 旁 边 的 放大 镜 图 标 残 能 弹出 一 些 选项 ， 然 后 在 
下 拉 有 菜单 中 选择 Edit Find Optionshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 见 图 7.6。 他 可 以 搜索 纯 文本 ， 也 可 以 搜索 正 
则 表达 式 ， 正 则 表达 式 能 指定 要 搜索 的 文本 出 现 的 位 置 : 搜索 的 文本 出 现在 一 段 话 的 前 面 、 中 间 、 任 意 位 置 还 是 匹配 整个 词 ， 也 
能 选择 是 否 大 小 写 敏感 ， 以 及 当 搜 索 到 文章 末尾 的 时 候 是 售 要 再 从 头 开 始 搜索 。 


一 人 | | 
Lo) Passer- rating ”| | passer-ral 








Q” Component 


Find Options 
Matching Style Textual 


Hits Must contain search term 


12 static 
13 double pinPassingComponent (do 





A7.6 ”在 搜索 标签 旁边 的 下 拉 菜 单 中 选择 Edit Find Options， 弹 出 的 菜单 中 有 能 满足 你 需要 的 选项 
User A 当然 想 让 搜索 大 小 写 敏感 ， 这 样 搜索 component 的 时 候 束 不 会 匹配 到 pinPassing-Component。 


如 果 想 要 使 用 更 灵活 的 方式 ， 而 又 不 使 用 正则 表达 式 ， 那 么 就 可 以 选 文本 搜索 ， 激 活 搜 索 框 ， 然 后 选择 Insert Pattern (^ 
VeéP) 。 这 样 就 会 列 出 常见 的 通配符 ， 比 如 文字 、 各 种 空格 ， 甚 至 邮件 、IP 还 有 网 址 。 任 选 一 个 添加 到 搜索 文本 中 。 


Oe 你 可 能 想 让 它 做 更 多 的 事 。 正 则 表达 式 中 ， 通 配 符 最 大 的 优点 就 是 你 可 以 挑选 出 通配符 匹配 的 实际 内 容 ， 然 后 使 
用 这 些 内 容 改 进 搜索 结果 或 者 做 文本 替换 。 当 使 用 简单 发 现 模式 时 ， 一旦 找到 与 模式 相 匹 配 的 文本 ， 就 无 法 再 访问 更 细节 的 内 


yy 


石 想 要 执行 蔡 换 操作 ， 可 以 单 击 搜索 栏 最 左边 的 弹出 菜单 ， 然 后 将 Find 改 为 Replace (或 者 使 用 命令 Find 一 Find and 
Replacehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/..., CEF, 4— PSA AIEARA BEA 
文本 ) 。 另 外 一 个 文本 框 用 于 填写 要 替换 的 文本 ， 他 输入 了 Comp。 蔡 换 栏 提供 了 3 种 行为 : 蔡 换 当前 文档 中 高 亮 显示 的 文本 ; 
替换 所 有 符合 匹配 的 文本 ; 如 果 按 住 Option 键 不 放 ，All 将 会 变 为 All in Selection。 他 想 要 蔡 换 整个 文件 中 的 实例 ， 所 以 他 放 开 
Option 键 ， 然 后 选择 了 All。 


Oe 如 果 User A 想 要 做 选择 替换 ， 那 么 他 不 得 不 用 点 小 技巧 ， 否 则 编辑 器 不 会 允许 他 这 人 么 做 。 第 规 的 做 法 是 先 选中 文 
本 ， 然 后 输入 要 查找 和 替换 的 字段 ， 最 后 再 使 用 选择 替换 的 功能 。 但 是 在 Xcode 中 没 办 法 这 样 做 ， 因 为 文本 内 的 搜索 是 递增 的 : 
在 没有 取消 选择 的 情况 下 ， 你 无 法 执行 查找 并 替换 的 操作 。 所 以 Uset A 不 得 不 先 输入 要 查找 的 内 容 和 要 替换 的 文本 ， 然 后 选择 这 
个 操作 想 要 执行 的 范围 。 


2. 更 改 和 和 冲突: 版 权 声 明 


同样 ， 他 也 注意 到 ，Xcode 将 所 有 文件 的 著作 权 都 给 了 Fritz Anderson ( 见 “ 这 是 谁 的 项 目 ” 部 分 ) . User ARAZ, ia 
让 上 passer-rating 中 有 更 多 属于 他 的 内 容 ， 所 以 使 用 查找 导航 器 将 Fritz Anderson 都 替换 成 了 User A。 本 章 后 面 我 会 告诉 你 User 
B 如 何 完 成 相同 的 操作 。 


理想 情况 下 ，Git 的 版 本 反映 了 项 目 文件 的 变更 。 每 次 提交 的 原因 都 各 不 相同 ， 即 便 更 改 了 多 个 文件 。User A 因为 两 个 目的 
对 文件 进行 了 修改 ， 修 正 了 文件 的 版 权 并 且 整 理 了 变量 名 。 如 果 遵 循 理想 情况 下 版 本 的 概念 ， 现 在 融 出 现 了 一 个 问题 ， 因 为 这 两 
个 修改 都 涉及 rating.c 这 个 文件 。 从 另 一 个 角度 讲 : 程序 员 可 能 希望 修改 一 个 文件 ， 完 成 一 项 任务 后 提交 文件 ， 之 后 再 根据 另外 
一 项 任务 对 文件 做 出 修改 ， 再 提交 。 


为 了 解决 这 个 问题 ，Git 在 add 命 令 中 添加 了 一 个 cherrypicking 选 项 ，Xcode 的 Commit 编 辑 器 又 进一步 加 强 了 这 个 功能 。 
在 代码 库 中 最 后 一 次 提交 的 代码 和 本 地 没有 提交 代码 的 标签 乙 间 有 两 个 控件 ， 见 图 7.7。 这 个 标签 右边 的 下 拉 荣 单 可 以 用 于 从 提 
交 计 划 中 排除 一 些 更 改 或 者 将 整个 更 改 都 从 未 提交 的 代码 中 移 除 。 标 签 的 左 侧 是 一 个 开关 : 如 果 它 是 一 个 对 号 ， 那 么 对 应 的 更 改 
MEEL, 如果 显 示 的 是 一 个 禁止 的 标记 ， 那 么 这 些 已 经 被 更 改 的 代码 束 会 变 灰 ， 这 次 提交 也 束 不 会 包含 这 些 更 改 。 这 也 是 
Xcode 的 版 本 控制 系统 支持 将 底层 系统 的 反 术 细节 包 沁 起 来 的 一 个 例子 。 


Paseer-rating > passer-rating ic] rating.< 


rating.c | rating.c 
passer-rating 3 f/f passer-rating 


Lreated by Fritz Anderson on /fa/l14. > ff Created oy Fritz Anderson on //s5/14. 
Copyright {c} 2014 User A. ALL rights |, fi _Canumioht (c) 2014 Fritz Anderson. 
reserved. —— Jon t Comms. Ss reserved. 


i Discard Change 
® include <stdio.h> IT M A medio. h= 
finclude "rating. h" ið #include “rating. h" 


i static i static 
3 double pinPassingComp(double component) < = 3 double pinPassingComponent(double 
{ component) 
if (component < 8.@) I { 
return 0.0; J5 if (component < 0.0) 


Cas m mm h 


W] passer-rating > Y master ) (4) Local Revision | a> "> (Oo M1214 Fritz Anderson 6c3ff0078ces (BASE, HEAD| 


passer-rating > passer-rating » [e] rating.c 

iif 
rating.c i f/f Frating.c 
passer-—rating 1 // passer—rating 

ff 
Created by Frit? Anderson on 7/5/14. 5 // Created by Fritz Anderson on 7/5/14. 
Copyright (c) 2014 User A. ALL rights | 5 //f Copyright (c) 2014 Fritz Anderson. 
reserved. === ALL rights reserved. 

| ff 


’ #include <stdio.h> 7 #include <stdio.h> 
) #include “rating.h" 1) #include “rating. h" 


static i static 
double pinPassingComp(double component) 3 double pinPassingComponent(double 
| component) 
if (component < 0.0) un { 
return 6.6; 15 if [component < 6.6) 


E passer-rating 》 Y master } (O) Local Revision a > Jo T24 Fritz Andersen GcdTf007aceb (BASE, HEAD) 





图 7.7 (EE) Xcode 的 提交 界面 提供 了 两 种 方法 用 于 管理 针对 一 个 文件 的 多 个 更 改 。 靠 近 更 改 标签 右 侧 的 下 拉 菜 单 能 让 对 应 的 代 
码 从 本 次 提交 中 排除 ， 或 者 完全 放弃 这 些 更 改 。 (下 ) 允许 /禁止 开关 能 更 方便 地 保留 代码 的 提交 。 第 二 上 段 代码 变 灰 ， 说 明 它 不 


会 被 提交 
User A 执 行 了 两 次 提交 操作 。 第 一 次 提交 中 没有 包含 版 本 更 改 的 信息 ， 仅 针对 代码 风格 进行 更 改 。 第 二 次 提交 包含 了 剩 下 
需要 更 改 的 所有 代码 。 最 后 ， 他 会 将 昧 计 的 提交 都 推送 到 共享 服务 器 。 
这 是 谁 的 项 目 


Xcode 的 源 文件 模板 在 最 上 面 的 标准 注释 中 包含 了 文件 名 (从 中 可 以 得 知 文 件 的 创建 以 及 命名 ) ,创建 的 日 期 (从 中 得 知 何 
时 创建 的 文件 ) ， 文 件 的 创建 者 ， 版 权 声 明 (从 文件 创建 到 现在 的 年 份 ) 。 创 建 者 的 名 字 以 及 版 权 拥 有 者 可 能 会 让 你 惊讶 。 它 是 
如 何 做 到 这 一 点 的 ? 


像 众多 现代 操作 系统 一 样 ，OS X 拥 有 可 以 运行 所 有 用 户 应 用 程序 的 账号 。 当 第 一 次 启动 Mac 的 时 候 ， 需 要 提供 一 个 简单 的 用 
户 名 和 一 个 稍微 长 点 的 自然 名 ， 用 作 这 台 计 算 机 的 第 一 个 用 户 名 。 如 果 你 添加 账户 ， 你 也 需要 为 这 些 账户 提供 自然 名 。Xcode 填 
A “创建 者 ”这 一 行 的 时 候 会 用 到 自然 名 。 


版 权 声 明 包 含 一 个 版 权 拥有 者 和 年 份 ， 法 律 要 求 它 必 须 这 样 做 。Xcode 填 充 这 个 字段 的 时 候 可 能 会 使 用 用 户 的 自然 名 。 但 是 
这 也 不 是 必需 的 。 当 你 创建 了 一 个 项 目 或 者 target 的 时 候 ，Xcode 会 询问 你 Organization Name， 用 这 个 名 称 作 为 版 权 拥 有 者 的 名 
字 。 对 于 你 自己 的 工作 来 说 ， 你 可 以 输入 自己 的 名 字 (Fritz Anderson) ， 但 是 如 果 为 别人 工作 ， 那 么 这 个 名 字 应 该 输入 项 目 拥有 
者 的 名 字 (The University of Chicago) 。 


如 果 不 行 ， 那 么 Xcode 会 使 用 通讯 录 中 “我 ”的 公司 名 称 。 若 还 是 失败 ， 就 会 用 “我 ”外 
如 果 一 开始 没有 设置 公司 名 称 ， 那 么 可 以 在 项 目 导 航 器 中 选中 项 目 (列表 最 上 面 的 条 目 ) ， 打 开 文 件 查 看 器 (显示 在 右 侧 的 
工具 区 域 ， 然 后 选择 看 起 来 像 是 一 页 纸 的 第 一 个 选项 卡 ) ， 然 后 修改 其 中 的 Organization 文 本 栏 。 


7.5.2 UserB 


User B 对 版 权 有 自己 的 看 法 ， 她 (错误 地 ) 假设 版 权 声明 如 果 使 用 作者 的 法 定 全 名 会 更 好 。 她 使 用 Fritz Anderson 著 换 了 所 
有 的 Frederic F.Anderson。 同 时 ， 她 也 将 项 目 查看 器 的 Organization 文 本 栏 设 置 为 了 对 应 名 称 ， 所 以 这 个 问题 不 会 再 出 现 。 


她 使 用 全 局 搜索 替换 的 方式 更 改 了 版 权 声 明 。 首 先 选 取 查 找 导 航 器 (第 三 个 选项 卡 ) ， 或 者 使 用 Find 一 Find in 
Projecthttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (fF) MS. 


查找 导 般 器 包含 一 个 搜索 框 和 一 些 选项 ( 见 图 7.8) 。 


E Ta 





Find » Text > Containing 
Qr 


In Project Ignoring Case + 








图 7.8 查找 导航 器 中 有 一 个 搜索 框 和 用 来 配置 查找 功能 的 选项 
稍 后 我 们 会 详细 介绍 这 些 选 项 ， 先 来 看 看 User B 能 看 到 的 内 容 : 


` 在 顶端 ， 路 径 控 件 中 显示 了 动作 (Find) 、 查 找 类 型 和 文字 边界 选项 (默认 情况 下 是 Text 和 Containing) 。 如 果 她 想 执行 替 
换 操 作 ， 而 不 仅仅 是 查找 ， 那 么 她 可 以 单 击 第 一 部 分 ， 然 后 将 其 更 改 为 Replace。 


: 名 为 In Project 的 按钮 《只 有 当 鼠 标 移 上 去 的 时 候 ， 它 才 会 显示 出 按钮 的 样式 ) ， 可 以 选择 搜索 功能 覆盖 的 文件 。 单 击 可 以 
查看 所 有 的 选项 ， 也 可 以 创建 属于 她 自己 的 搜索 方式 ， 然 后 再 点 一 下 这 个 按钮 完成 选择 。in-ptoject 搜 索 就 是 她 想 要 的 结果 。 


. 有 一 个 弹出 菜单 能 够 更 改 大 小 写 。 现 在 这 一 点 并 不 重要 ,但 是 她 应 该 记得 查看 一 下 ， 否 则 她 可 能 会 得 到 与 期 待 不 符 的 结 


“ 搜索 区 域 下 拉 框 的 放大 镜 中 包含 了 最 近 的 搜索 历史 ， 与 在 文件 搜索 区 域 中 提供 的 字符 匹配 规则 相同 。 


User B 在 搜索 框 中 输入 Fritz Anderson 然 后 按 回 车 键 。 下 面 的 列表 中 将 会 显示 出 所 有 匹配 的 结果 ， 它 们 按照 文件 组 织 ， 显 示 
出 其 中 相 匹 配 的 内 容 。 虽 然 显 示 的 内 容 只 有 一 行 ， 但 是 也 比 没有 好 。 单 击 一 个 结果 就 能 看 到 整个 文件 内 容 ， 也 很 方便 ， 见 图 
7.9。 


Oe 执行 全 局 替换 的 按钮 直到 搜索 结束 才 会 激活 ， 未 完成 搜索 操作 之 前 不 允许 育 目 执行 替换 操作 。 


User B 有 一 个 问题 : 她 想 纠正 版 权 声明 ， 但 是 文件 仍然 视 Fritz Anderson 为 创建 者 。 她 友 现 匹配 的 数量 比 她 想 要 的 数量 多 得 
多 。 她 有 两 种 方法 可 以 解决 这 个 问题 : 





Replace } Text > Containing 
Ly Fritz Anderson @ 
In Project Ignoring Case 二 
Frederic F. Anderson 

Preview Replace Replace All 


b results in 3 files 


5 main.c 
passer-rating project 
i Created by Fritz Anderson on 
o MB. 
H Copyright (c) 2014 Fritz Anderson. 
All rights reserved. 
5 rating.c 
passer-rating project 
H Created by Fritz Anderson on 
= MBa. 
H Copyright (c) 2014 Fritz Anderson. 
All rights reserved. 
> rating.h 
y h) passer-rating project 
i Created by Fritz Anderson on 
= Mer. 
H Copyright (c) 2014 Fritz Anderson. 
All rights reserved. 


图 7.9 在 项 目 中 搜索 得 出 的 结果 ， 呈 现 方式 是 按 文件 组 织 的 表 ， 每 个 结果 用 一 行 显示 。 查 找 导 航 器 已 经 切换 到 了 替换 模式 ， 并 


且 准 备 好 将 所 有 的 Fritz Anderson#7# AW Frederic F.Anderson 


` 她 可 以 按 command 键 ， 再 单 击 想 要 替换 的 实例 ， 然 后 单 击 Replace 〈 它 现在 已 经 处 于 激活 状态 ， 为 替换 当前 选择 和 替换 所 
有 稍微 有 些 区 别 ， 和 替换 全 部 将 会 替换 所 有 的 实例 ， 而 替换 当前 选择 的 则 仅 会 对 当前 选择 的 有 影响 ) o 


. 她 也 可 以 单 击 Pteview。 
如 果 她 选择 了 预 抱 ， 那 么 将 会 出 现 一 个 很 熟悉 的 界面 ， 与 对 比 编辑 器 类 似 的 编辑 器 ， 见 图 7.10。 它 包含 符合 匹配 的 所 有 源 代 


码 列表 ， 以 及 每 个 匹配 内 容 的 上 下 文 。 单 击 开关 可 以 选择 接受 替换 或 者 拒绝 蔡 换 。 她 选择 了 不 蔡 换 创建 者 ， 然 后 单 击 Replace 按 
tHo 


这 是 她 第 一 次 执行 影响 整个 项 目的 命令 ， Xcode 会 弹出 一 个 界面 提示 保存 项 目 快照 ， 见 图 7.11。 项 目 快 照 是 一 个 能 让 你 将 整 
个 项 目 回 退 到 更 改 之 前 状态 的 一 种 方式 ， 这 也 是 迫不得已 的 最 后 一 种 方式 。 


在 组 织 窗口 中 的 Project 面 板 (122) 能 找到 用 于 还 原 的 快照 。 选 择 项 目 和 一 个 快照 ， 快 照 列 表 下 面 的 按钮 将 会 提供 Export 
Snapshot 的 功能 。Xcode 特 意 使 用 export (导出 ) 这 个 词 ， 导 出 的 结果 将 会 是 一 个 仔 放 快 照 的 独立 文件 夹 ， 而 不 是 正在 工作 的 
项 目的 上 一 个 版 本 。 


你 也 可 以 通过 选择 File 一 Project Settingshttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 改 变 想法 ， 编 辑 Snapshots 选 项 卡 。 


快照 模仿 了 那些 没有 使 用 过 版 本 管理 系统 的 开 友 者 的 行为 习惯 ， 但 是 这 并 不 是 版 本 管理 的 一 个 蔡 代 方案 。 频 每 使 用 快照 功能 
简直 不 可 理喻 ， 因 为 这 样 融 没 有 办 法 根据 他 们 的 目的 来 分 离 更 改 ， 也 无 法 浏览 乙 前 的 版 本 。 应 当 将 快照 功能 作为 版 本 管理 系统 都 
不 可 逆转 时 的 一 种 解决 方案 。 














2 matches | 


fel main.c | T le main.c in passer-rating project 
passer-rating project a. = = 一 -一 一 一 -一 -一 一 一 
` Anderson on 7/5/14. 7/5/14, 

EV Created by Entz Ander | yf Copyright (c) 2014 Frederic — ¥f Copyright (c) 2014 Fritz 
EV Copyright (c) 2014 Erit | F, Anderson. ALL rights 

¥ fe rating.c 

Di Anderson on 7/5/14. 7/5/14, | 

E| # Created by Fritz Ander | // Copyright (c) 2014 Frederic /i Copyright (c) 2014 Fritz 
三 | # Copyright (c) 2014 Frit | Fa Anderson. ALL rights Anderson. ALL rights reserved. 
. rating.h reserved, ff 

z Ih) passer-rating project fi 
(=| Created by Fritz Ander 
[=| Copyright (c) 2014 Frit |- 



















































































¥ le] rating.c in passer-rating project 2 matches 
if fi 

ff Created by Frederic F. /f/ Created by Fritz Anderson on 
Anderson on 7/5/14. y 7/5/14. 

ff Copyright (c) 2014 Frederic z " ff Copyright (c) 2014 Fritz 

F. Anderson. ALL rights 























Anderson on 7/5/14. l E | 7/5/14. 
AAA Copyright (c) 2014 Frederic // Copyright (c) 2014 Eritz 
Es Angerson. ALL rights a | Anderson. All rights reserved. | 



































Cancel Replace 





A710 ASRHRRILA P BEPreviewRH, SEPASHAALAAELEF RYH MACH. APLAN AY FUAA-AFTK, ik 


你 选择 接 腾 还 是 取消 这 个 更 改 


Would you like Xcode to take automatic snapshots 
before Batch Find & Replace and similar operations? 


code can automatically create snapshots of ts project before sarl 
mass-aditing operation. You can change the anapshot proforancee 
for this project by choosing File > Project Settings 























Disable 





图 7.11 这 是 你 第 一 次 执行 涉及 整个 项 目的 更 改 ，Xcode 提 供 了 创建 快照 的 方法 ， 以 保留 当前 的 项 目 状 态 


User B 将 她 的 更 改 提 交 到 本 地 代码 仓库 ， 之 后 执行 推送 操作 。 
7.5.3 ”返回 User A 


User AHT TEF (Source Control>Pushhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...) ， 但 发 现 无 法 正常 工作 。 弹 出 的 警告 面板 告诉 
他 ， 现 在 他 本 地 的 代码 版 本 ， 即 便 不 包含 他 所 做 的 那些 更 改 ， 也 低 于 想 要 推送 的 版 本 库 的 版 本 。 “落后 ”一 般 来 很 难 用 来 形容 开 
发 者 的 文件 状态 ， 比 如 说 在 这 里 ， 本 地 的 文件 实际 上 比 远 程 代码 仓库 中 的 文件 还 要 新 。 在 版 本 管理 系统 中 ， 如 果 远 程 版 本 库 做 了 
一 些 更 改 ， 而 本 地 没有 更 新 的 话 ， 那 么 本 地 版 本 丈 会 比 远 程 版 本 库 中 的 版 本 低 。 


在 将 本 地 更 改 推送 到 远程 服务 器 之 前 ， 首 先 本 地 要 更 新 远程 服务 器 中 的 代码 。 选 择 Source Control—Pull... (CÆX) ， 然 
后 在 下 拉 菜 单 中 选择 origin/master (这 是 唯一 的 选择 ) ， 单 击 Pull 按 钮 。Git 从 远程 服务 器 中 拉 取 内 容 的 时 候 ， 会 出 现 一 个 表示 
进度 的 旋转 指示 器 ， 当 Xcode “检测 到 冲突 ”的 时 候 ， 会 出 现 一 个 进度 显示 器 。 


在 他 想 要 提交 的 3 个 文件 中 ， 出 现 了 一 些 ; 冲 突 。 如 果 使 用 的 是 Git 命 令 行 ， 那 么 显示 的 内 容 非 常 元 繁 ， 因 为 你 不 得 不 参考 冲突 
列表 ， 然 后 找到 Git 式 加 到 ;中 突 文件 中 的 记号 ， 记 住 你 想 要 保存 冲突 中 的 哪个 版 本 ， 然 后 使 用 git add 命 令 将 它们 添加 a 到 暂 存 区 。 


1. 合 并 版 本 


Xcode 已 经 解决 了 大 部 分 版 本 合并 让 人 头痛 的 事情 ， 你 仅 需 决定 要 使 用 哪个 版 本 。 一 旦 检测 到 冲突 ，Xcode 束 会 告诉 你 无 法 
完成 推送 操作 ， 除 非 解决 了 所 有 /中 突 。 对 比 界面 左 侧 的 源 文件 列表 将 会 显示 出 拉 取 操作 引起 的 警告 ( 见 图 7.12) 。 其 中 有 一 些 不 
需要 操心 一 一 Git 会 目 行 决 定 如 何 一 行 行 地 合并 更 改 一 一 但 是 如 果 同一 行 代码 被 两 个 开 友 者 在 同一 个 版 本 上 进行 了 更 改 ，Git 就 无 
法 目 行 做 出 选择 ， 这 时 残 需要 你 手动 解决 。 


















































日 rating.c ‘cl rating.c 


hi rating.h hi rating.h 





A712 (Æ) 当 你 从 服务 器 更 新 代码 的 时 候 ， 若 与 本 地 代码 发 生 冲 突 ，Xcode 的 合并 编辑 器 就 会 列 出 所 有 冲突 的 文件 ， 并 将 其 
用 红色 的 C 记 号 标记 。 (A) 一 旦 解决 了 冲突 ， 这 个 C 记 号 就 会 变 灰 ， 这 样 才 能 完成 拉 取 操作 


rating.c 这 个 文件 最 有 趣 ， 它 有 一 行 发 生 冲 突 ， 但 是 还 有 很 多 行 Git 处 理 起 来 曲 无 压力 。User A 的 本 地 版 本 绝 大 多 数 时 间 会 
在 左边 显示 ， 将 要 被 拉 取 下 来 的 版 本 在 右边 。 编 辑 器 ( 见 图 7.13) 底下 有 一 个 控件 ， 会 让 他 选择 使 用 哪个 版 本 的 代码 。 


Rig nt then Left 





图 7.13 合并 编辑 器 底部 的 控件 给 出 了 4 种 解决 冲突 的 方法 : 在 本 地 代码 后 面 使 用 远程 代码 ; 使 用 本 地 代码 ; 使 用 远程 代码 ; 以 
及 在 远程 代码 后 面 使 用 本 地 代码 。 同 时 使 用 两 个 版 本 代码 的 情况 只 有 在 发 生 冲突 的 时 候 才 能 使 用 


O68 我 说 “ 绝 大 多 数 时 间 (more orless) ”是 因为 需要 显示 3 个 版 本 一 一 本 地 的 代码 版 本 ， 远 程 代码 版 本 ， 以 及 你 做 出 
选择 之 后 的 版 本 一 一 Xcode 只 能 同时 看 到 其 中 的 两 个 版 本 。 左 边 的 视图 一 般 显示 做 出 选择 之 后 的 版 本 。 但 是 只 有 你 选择 使 用 自己 
的 代码 行 ， 才 能 在 合并 的 最 后 结果 中 看 到 它们 。 这 个 控件 上 暗示 你 需要 选择 “左边 的 版 本 ， 但 是 除非 你 选择 它 ， 否 则 无 法 在 左边 


看 到 。 





2. 没 有 冲突 的 代码 行 


让 我 们 从 最 简单 的 地 方 做 起 : 没有 冲突 的 部 分 。 黑 认 情况 下 ，Git 命 令 行 会 自动 合并 没有 冲突 的 代码 行 : 如 果 只 有 一 个 版 本 
更 改 了 同一 个 父 版 本 的 代码 行 ， 那 么 会 目 动 合并 更 改 的 代码 。 


Xcode 为 你 提供 了 更 多 控制 权 。 合 并 编辑 器 用 监 色 高 党 显示 被 更 改 的 每 一 行 ， 中 间 市 有 看 上 去 像 是 一 个 滑动 开关 的 标识 器 。 
本 地 版 本 在 左 侧 ,远程 版 本 在 右 侧 。 滑 动 开关 偏向 你 选择 的 那个 版 本 。 你 无 法 直接 使 用 标识 器 。 而 是 选中 你 要 使 用 的 那个 版 本 的 
代码 行 ( 仔 细 看 选中 代码 行 的 蓝 色 边 框 一 一 不 明显 ， 很 容易 遗漏 ) ， 然 后 使 用 编辑 器 下 面 的 控件 做 出 你 的 选择 ， 见 图 7.14。 
中 的 选择 是 同时 使 用 两 个 版 本 ， 一 个 在 另外 一 个 版 本 的 代码 后 面 ， 这 种 万 式 仅 仪 适用 于 有 冲突 的 代码 行 。 





double completionComp = a double completionComponent = 
(((double) comps / atts) * 100.0 - 30.0) / (({double) comps / atts) * 100.0 - 30.0) / 
20.0; 20.0; 





completionComponent = pinPassingComponent ) 7 completionComponent = pinPassingComponent 


letionComponent); (comp letionComponent) ; 








double yardageComp = | double yardageComponent = 
(((double) yds / atts) - 0.3) / 4.8; ((({double) yds / atts) - 0.3) / 4.0; 





图 7.14 Git 不 会 让 你 挑选 合并 哪些 代码 行 ， 但 是 Xcode 将 所 有 可 能 的 更 改 都 显示 出 来 了 ， 让 你 决定 是 否 接 受 这 些 更 改 


3. 有 冲突 的 代码 行 


RI PATHE APSA CAST. User A 和 User B 工 作 开 始 时 使 用 的 版 本 版 权 声 明 都 为 Fritz Anderson。 之 后 ， 他 们 分 别 用 目 
已 的 名 字 更 改 了 版 权 声 明 的 内 容 。Git 不 知 如 何 选 取 ， 所 以 它 报告 了 一 个 冲突 ， 让 你 决定 使 用 哪个 版 本 。 冲 突 的 代码 行 都 用 红 框 


高 亮 显 示 ， 在 两 个 版 本 中 间 ， 同 样 有 一 个 椭圆 形 的 标记 。 但 是 这 次 不 是 滑动 器 : 因为 不 能 两 者 选择 一 个 ， 所 以 椭圆 形 的 标记 中 间 
是 一 个 问号 ， 见 图 7.15 上 。 


Created by Fritz Anderson on 7/5/14. 5| / Created by Fritz Anderson on 7/5/14. 
Copyright (c) 2014 User A. ALL rights reserved. CC?) 6 // Copyright (c) 2014 Frederic F. Anderson. ALL rights 
reserved. 


Created by Fritz Anderson on 7/5/14. 5 / Created by Fritz Anderson on 7/5/14. 

Copyright (c) 2014 User A. ALL rights reserved. : 5 6 Copyright (c) 2014 Frederic F. Anderson. ALL rights 
Copyright (c) 2014 Frederic F. Anderson. All rights K > reserved. 

reserved. wy 


5 // Created by Fritz Anderson on 7/5/14. 
Created by Fritz Anderson on 7/5/14. ee 6 YA Copyright (c) 2014 Frederic F. Anderson. All rights 


Copyright {c} 2014 User A. ALL rights reserved. 4 d reserved. 


5 // Created by Fritz Anderson on 7/5/14. 
6 // Copyright (c) 2014 Frederic F. Anderson. ALL rights y ` 6 // Copyright (c) 2014 Frederic F. Anderson. ALL rights 
reserved. = reserved, 


Created by Fritz Anderson on 7/5/14. 5 f/f Created by Fritz Anderson on 7/5/14, 

Copyright (c) 2014 Frederic F. Anderson. All rights =e 6 // Copyright (c) 2014 Frederic F. Anderson. All rights 
reserved. m reserved. 

Copyright (c) 2014 User A. ALL rights reserved. — 7 ff 





图 7.15 (EE) 若 自 从 上 个 共同 的 版 本 以 来 ， 一 个 文件 的 部 分 代码 分 别 被 不 同 的 人 修改 ， 就 会 引发 冲突 。Xcode 会 将 冲突 的 内 容 
PERRET, 但 是 它 不 会 在 两 者 之 间 做 出 选择 ， 高 亮 的 红 框 之 间 有 一 个 带 有 问号 的 椭圆 形 标 记 。Merge 页 面 的 底下 有 一 个 控 
两 者 之 间 如 何 选 择 (上 数 第 2 至 最 后 ) : 本 地 代码 在 远程 代码 之 前 、 本 地 代码 、 远 程 代 码 、 远 程 代码 在 本 地 


代码 之 前 


User A 会 使 用 界面 下 方 的 控件 来 解决 冲突 。 在 这 个 例子 中 ， 他 选择 退让 ， 使 用 Fritz Anderson， 然 后 选择 控件 上 的 第 3 个 选 
项 (使 用 远程 代码 ) 。 对 于 剩 下 没有 冲突 的 代码 行 ， 他 坚持 使 用 简短 的 变量 名 。 所 以 他 选择 第 2 个 选项 〈 使 用 本 地 代码 ) 保持 目 
己 的 更 改 。 


当 解 决 了 所 有 的 冲突 之 后 ( 见 图 7.12 右 侧 的 源 文件 列表 ) ，Xcode 就 会 激活 Pull 操 作 的 按钮 ， 只 有 这 个 时 候 ，User A 的 代码 
才能 反映 出 最 后 的 结果 。 


4. 提 交 更 改 


解决 冲突 时 所 做 的 修改 和 其 他 任何 种 类 的 修改 一 样 ， 这 些 修改 都 只 体现 在 本 地 ， 没 有 影响 远程 代码 仓库 。 与 其 他 任何 被 修 改 
过 的 文件 一 样 ， 项 目 导 航 器 会 将 这 些 文件 用 M 标 记 。UserA 必 须 将 这 些 合并 后 的 文件 提交 到 本 地 代码 仓库 中 (合并 完成 后 会 出 现 
提交 的 提示 信息 ) ， 然 后 将 本 地 代码 推送 到 远程 代码 仓库 中 。 假 设 远 程 代码 仓库 没有 获得 任何 来 自 User B 的 更 改 ， 那 么 融会 成 
功 完成 这 次 推送 操作 。 


他 可 以 友 送 一 封 邮件 给 User B， 让 她 知道 远程 代码 仓库 友 生 了 一 些 更 改 ， 执 行 拉 取 操作 残 能 看 到 这 些 更 改 。 也 可 以 让 她 目 
行 发 现 这 些 更 改 ， 不 过 这 也 就 意味 着 User A 与 User B 协 作 方 面 可 能 会 出 现 一 些 令 人 担忧 的 事 。 


7.6 ”版 本 编辑 器 


如 果 你 看 不 到 更 改 后 的 代码 ， 那 么 将 代码 提交 到 版 本 管理 系统 中 ， 或 者 合并 代码 宫 无 意义 。Xcode 的 版 本 管理 器 (工具 栏 中 
Editor 控 件 的 第 3 部 分 ) 能 让 你 看 到 更 改 的 内 容 。 单 击 版 本 编辑 器 分 隔 符 ， 然 后 保持 鼠标 的 按 下 状态 (图 7.16) 。 版 本 编辑 器 有 3 
个 视图 : 


¥ *-s Comparison 


Blame 
cu Log 
































图 7.16 Editotr 右 边 的 控件 有 一 个 下 拉 菜 单 ， 从 中 可 以 选择 版 本 管理 的 3 种 编辑 器 


- 很 快 会 频繁 使 用 的 Compatison 编 辑 器 ， 你 也 已 经 见 到 了 这 个 编辑 器 ， 当 代码 重 构 或 者 进行 版 本 管理 操作 需要 显示 两 次 版 本 
之 间 代 码 更 改 的 时 候 ， 都 要 用 到 Compatison 编 辑 器 。 


. Blame 会 将 文件 分 散 显示 ， 从 中 反映 出 菜 一 行 的 当前 版 本 是 由 哪 次 提交 操作 决定 的 。 
. Log 视图 列 出 了 影响 当前 文件 的 全 部 提交 操作 。 


我 将 会 逐一 介绍 ， 先 从 Comparison 视 图 开始 。 


7.6.1 Comparison 


如 果 你 一 直 按照 本 书 的 步骤 操作 ， 那 么 passer-rating 这 个 项 目 已 经 积累 了 由 不 同 用 户 提 交 的 多 个 版 本 。 选 择 其 中 一 个 源 广 
件 ， 将 编辑 器 切换 到 版 本 视图 。 这 个 视图 会 分 为 两 个 面板 : 左 侧面 板 中 显示 的 是 文件 当前 的 状态 ; 右 侧面 板 显 示 了 该 文件 最 后 提 
交 的 一 个 版 本 ， 见 图 7.17。 


现在 ,它们 基本 上 一 人 致 ， 但 是 尝试 修改 一 下 当前 文件 ， 你 会 友 现 编辑 器 中 会 出 现 一 个 监 条， 从 你 更 改 的 地 万 一 直 延 伸 到 已 提 
交 版 本 的 相同 位 置 。 如 果 你 在 一 行 中 做 了 一 些 更 改 ， 那 么 两 个 版 本 不 同 的 地 万 会 用 上 暗 黄 色 高 亮 显 示 。 


@ je SB p... > Æ My Mac passer-rating: Ready | Today at 11:46 PM 


OHRQA O = og 六 | passer-rating passer-rating > (e| rating.c passer_rating() 
m passer-rating fi | 
i OS X SDK 10.10 | fj rating.c 2 Z rating.c 
¥ |_| passer-rating : / | passer—rating | l passer-rating 
c| main.c Ane ; i 
= à / Created by Fritz Anderson on 7/5/14. / Created by Fritz Anderson on 7/5/14. 
ot lal // Copyright (c) 2014 Frederic F. Anderson. All Copyright (c) 2014 Fritz Anderson. All rights 
[K] rating.h rights reserved. reserved. 
aa /7 
> #include <stdio.h> ) #include <stdio.h> 
#include "rating.h" #include "rating.h" 


12 static i2 static 
3 double pinPassingComp(double component) 3 double pinPassingComponent(double component) 
{ { 


if (component < 0.0) if (component < 0.0) 
return 0.0; return 0.0; 
else if (component > 2.375) else if (component > 2.375) 
return 2.375; 18 return 2.375; 
else ) else 
return component; return component; 
L| } 21| } 


23 float 2: f loat 
+ passer_rating(int comps, int atts, int yds, int passer_rating(int comps, int atts, int yds, int 
tds, int ints) tds, int ints) 
{ 


// See http://en.wikipedia.org/wiki/ // See http://en.wikipedia. org/wiki/ 
Quarterback Rating Quarterback Rating 


if (atts == @) } if (atts == @) 
return 0.0; 29 return 0.0; 


double completionComp = 31 double completionComponent = 
((({double) comps / atts) * 32 (((double) comps / atts) * 





5 passer-rating-7 》 master ) (© Local Revision wo (Gj passer-rating-7 ) Y master » (5 7/7/14 Fritz Anderson d22180162f7f 


-一 


图 7.17 版 本 编辑 器 中 Compatison 视 图 将 一 个 文件 的 两 个 版 本 并 排放 在 一 起 ， 并 会 高 亮 显 示 两 个 版 本 之 间 的 不 同 之 处 。 底 部 的 跳 
转 栏 能 让 你 在 不 同 的 版 本 和 分 支 之 间 切 换 


编辑 器 窗口 都 是 真实 可 用 的 编辑 器 : 你 可 以 随意 修改 ， 虽然 对 已 经 提交 的 文件 进行 更 改 不 会 起 作用 。 在 这 两 个 版 本 所 有 被 修 
改 的 行 中 间 ， 都 有 一 个 逢 序列 化 的 标签 。 单 击 这 个 标签 ， 选 择 这 个 修改 ， 一 旦 选中 了 对 应 的 修改 ， 残 能 用 光标 键 迅 速 在 不 同 的 更 
改 之 间 切 换 。 在 标记 的 右边 有 一 个 三 角 ， 单 击 会 出 现 一 个 下 拉 荣 单 ， 其 中 只 有 一 个 选项 : Discard Change， 这 个 选项 能 让 你 忽 
略 当前 的 修改 ， 与 上 一 个 版 本 保持 一 致 。 


= 如 果 你 想 要 放弃 从 上 个 版 本 以 来 对 整个 文件 做 的 所 有 修改 ， 并 不 需要 这 样 逐 一 取消 修改 。 在 项 目 导航 器 中 右 击 对 
应 的 文件 ， 然 后 从 弹出 菜单 中 选择 Source Control—Discatd Changeshttp: //www.hzcourse.com/resoutce /teadBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... 就 能 放弃 所 有 的 修改 。 如 果 文 件 查 看 器 显示 在 工具 区 中 ， 
那么 有 一 块 位 置 会 显示 出 所 选 文件 版 本 控制 状态 的 详细 信息 ， 其 中 也 包括 一 个 
Discardhttp: //www.hzcourse.com/resoutce /teadBook?path= /openresources/teach_ebook /uncompressed/15555/OEBPS/Text/... #421 
如 果 你 想 要 放弃 对 所 有 文件 的 更 改 ， 只 需要 选择 Source Control—Discard All Changeshttp://www.hzcourse.com/resoutce/treadBook? 


path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/...。 


编辑 器 并 不 仅 限 于 显示 最 后 的 两 个 版 本 ， 在 每 个 窗口 的 底下 你 都 能 找到 一 个 跳 转 柱 ， 它 被 划分 为 几 段 ,分 别 是 : 版 本 库 、 分 
文 以 及 当前 窗口 显示 的 版 本 。 每 一 部 分 都 有 一 个 弹出 菜单 ， 你 可 以 将 编辑 器 一 分 为 二 ， 显 示 你 想 要 看 的 任意 版 本 ， 然 后 你 残 能 
到 指定 版 本 之 间 的 全 部 不 同 。 


选择 指定 版 本 还 有 一 个 更 简单 的 方法 。 单 击 窗口 之 间 栏 距 (gutter) 底部 的 时 钟 图 标 ， 就 会 看 到 一 个 带 有 长 短 不 一 标记 的 黑 
色 时 间 线 ， 稍 短 的 标记 表示 这 个 版 本 对 当前 文件 有 过 操作 ， 长 一 些 的 标记 记录 了 时 间 ， 见 图 7.18。 在 时 间 线 上 移动 鼠标 ，Xcode 
会 在 鼠标 芳 边 显示 一 个 悬浮 面板 ， 其 中 包含 日 期 、 版 本 ID、 提 和 交 者 以 及 对 应 版 本 的 描述 信息 。 


20.0 * (double) 
touchdownComp = pinPassingComp( 


double pickComp = 
atts); 2.375 - (25.0 + 


pickComp = 


July 13, 2014 at 10:11 PM 
Revision 78d5cd959443 


Es 
CB i Committed by User B 


§ Correct the name of the copyright holder to Frederic F. 
> Anderson 
| i 





图 7.18 ” 单 击 对 比 编辑 器 撒 部 中 间 的 时 钟 图 标 ， 会 出 现 一 个 表示 当前 文件 版 本 的 时 间 线 。 当 鼠标 经 过 时 间 线 上 的 时 间 点 时 ， 会 显 
示 出 对 应 版 本 的 信息 。 单 击 时 间 点 的 任意 一 侧 ， 都 会 将 对 应 版 本 的 文件 显示 在 相应 侧 的 编辑 器 中 


在 时 间 线 的 两 头 各 有 一 个 简 头 。 单 击 时 间 线 ， 将 箭头 移动 到 单 击 的 那 一 侧 ， 对 应 侧 的 编辑 器 就 会 显示 这 个 版 本 的 文件 。 


图 形 化 的 Comparison 编 辑 器 是 查看 代码 修改 的 一 种 强大 手段 ， 但 是 如 果 你 想 要 与 他 人 沟通 更 改 的 代码 位 置 ， 它 不 是 很 实 
用 。 你 必须 让 其 他 人 能 够 获得 你 的 版 本 库 完 整 的 访问 权限 ， 要 求 他 们 购买 Mac 计 算 机 ， 注 册 为 Apple 开 友 者 ， 而 且 还 要 安 委 
Xcode。 还 有 一 种 方法 ， 选 择 Editor 一 Copy Source Changes， 这 样 就 能 将 更 改 的 内 容 按照 diff 命 令 中 的 格式 复制 到 粘贴 板 中 。 


7.6.2 Blame 
Comparison 视 图 根据 一 个 时 间 点 来 显示 两 个 版 本 之 间 增 量 的 更 改 。Blame 视 图 能 让 你 看 到 一 个 文件 的 另 一 面 : 谁 、 由 于 什 
么 原因 、 人 在 何 时 、 修 改 了 当前 文件 的 哪 一 部 分 。 在 版 本 编辑 器 的 工具 栏 中 选择 Blame， 葡 能 看 到 Blame 视 图 。 


全 注意 Blame 是 版 本 管理 系统 中 的 一 个 技术 名 词 ， 当 使 用 这 个 命令 时 ， 能 反映 出 开发 者 想 要 追究 是 谁 做 了 相应 修改 时 的 情 


绪 。Subversion 巧 妙 地 提供 了 credit 这 个 类 似 的 功能 。 

编辑 器 右手 边 的 面板 消失 ， 取 而 代 之 的 是 一 列 注 释 。 每 一 条 注释 都 能 匹配 代码 中 的 对 应 行 。 最 差 的 情况 下 ， 它 也 能 显示 出 最 
后 一 次 提交 操作 的 作者 和 时 间 。 如 果 空 间 人 允许 ， 注 释 中 会 包含 提交 的 摘 述 ， 见 图 7.19。 单 击 注释 中 的 信息 按钮 ， 束 能 看 到 对 应 提 
交 的 详细 信息 。 


与 之 前 一 样 ， 你 也 可 以 在 编辑 器 底部 的 跳 转 栏 中 选择 当前 文件 的 任意 一 个 版 本 ， 碍 看 文件 贡献 者 修改 该 文件 的 全 部 历史 记 
录 。 


Fritz Anderson 
rating.h Add rakina itl Fe 
passer—rating 


Created by Fritz Anderson on 7/5/14. 

Copyright (c) 2014 Frederic F. Anderson. All rights reserved, User B 13, 2014 
Fritz Anderson S 15, 2014 

y #itndet passer_rating_rating_h 

ið #define passer_rating_rating_h 


| float passer_rating(int comps, int atts, int 
int tds, int ints); 





i+ #endif 


国产 Fritz Anderson Jul 5, 2014 
2 ff rating. hi Add rating dhc for function passer _ratinad 
3 f/f passer-—rating User B 
a | 
1 ff Created by Fritz Anderson on 7/5/14. i 
f/f Copyright (le) 2014 Frederic F. Anderson. All rights Correct the name ef the copyright holder to Frederic F. g 
inf; Anderson 4 
9 #ifndet passer_rating_rating_h Open h Comparison 


10 #aeTine passer_rating_rating_n 
1 float passer_ratinglint comps, int atts, int yds, 


13 int tds, int ints); 
14 #endif 


图 7.19 (E) Blame 列 出 了 一 个 文件 中 每 组 代码 的 对 应 注释 ， 其 中 包含 了 对 应 提交 操作 的 详细 信息 。 大 块 的 空间 能 显示 更 多 的 
信息 。 编 辑 器 右边 栏 中 密集 地 显示 了 最 近 的 版 本 信息 。 (F) 单 击 注释 信息 中 的 信息 按钮 ， 就 会 弹出 这 次 提交 的 完整 信息 ， 包 括 
对 应 负责 人 的 信息 ， 所 以 你 能 通过 单 击 这 个 信息 抒发 你 的 不 满 


7.6.3 Log 


Log 视 图 提供 了 观察 一 个 文件 历史 记录 的 第 3 种 方法 。 在 版 本 编辑 器 工具 栏 的 下 拉 荣 音 中 选择 Log 视 图 。 它 是 文件 的 一 个 独 
立 视图 ， 与 在 跳 转 栏 中 选择 的 版 本 类 似 。 石 边 的 列表 中 显示 该 文件 完整 的 历史 记录 信息 ， 当 然 也 仪 包 含 这 个 文件 的 历史 记录 信 


T 


/LO 


与 文件 (合并 的 不 算 ) 相关 联 的 版 本 会 包含 一 个 注释 ， 如 Show 2 modified files。 单 击 这 个 提示 ， 就 会 出 现 一 个 对 比 浏 览 
面 ， 其 中 包含 一 个 这 个 版 本 提交 的 全 部 源 文 件 列 表 ， 还 有 一 个 所 选 文件 提交 前 后 内 容 对 比 的 界面 。 


Ore . — 
Da E gt 命令 行 工具 会 提供 一 些 类 似 的 功能 ， 你 可 能 会 更 喜欢 这 些 功能 : git log--name-only 会 打印 出 当前 历史 中 的 每 个 版 
其 中 还 包含 提交 信息 和 一 个 每 个 版 本 所 更 改 的 文件 列表 。 


还 有 一 个 问题 ， 编 程 并 不 是 一 个 线性 事件 。 我 们 积累 了 这 么 多 有 版本， 融 好 像 是 一 个 统一 的 过 程 ， 其 中 的 每 一 步 都 在 同一 个 更 
大 更 完整 的 程序 迈进 。 但 这 不 是 真实 的 生活 。 在 实际 中 ， 你 可 能 会 对 产品 产生 一 些 独特 的 想法 ， 不 过 在 尝试 这 些 想 法 的 时 候 也 不 
想 污 染 稳 定 的 “好 ”版 本 。 


此 时 ， 就 可 以 开启 分 支 (branching) ， 它 能 让 你 在 一 个 单独 的 开发 线 (分 支 ) 中 继续 工作 ， 当 你 需要 这 些 更 改 的 时 候 ， 也 
可 以 将 更 改 合并 到 主干 中 。 到 现在 ，pass-rating 这 个 项 目 还 是 大 简单 ， 不 能 作为 曾 述 分 支 这 个 概念 的 好 例子 。 所 以 ， 这 里 我 仅 
会 介绍 分 支 的 工作 原理 ， 你 可 以 参考 图 7.20。 


master 





good-idea 


图 7.20 项 目的 主线 开发 在 mastetf 这 个 分 支 中 。 若 开发 者 想 要 实现 一 些 想 法 ， 她 可 以 创建 一 个 名 为 good-idea 的 分 支 ， 并 在 good-idea 
开发 的 过 程 中 ， 人 偶尔 合 并 一 下 来 自 mastet 中 的 更 改 。 当 实现 自己 的 想法 之 后 ，good-idea 中 的 更 改 可 以 反 过 来 再 合并 到 mastet 分 支 中 


Git 或 者 Subversion 中 的 每 个 项 目 都 从 一 个 分 支 开 始 开 发 ， 这 个 分 支 在 Git 中 名 为 master。 我 们 的 例子 同样 也 是 从 这 个 分 支 
开始 ， 当 开发 者 有 了 一 个 好 想法 的 时 候 ， 可 以 创建 一 个 名 为 good-idea 的 分 支 (这 个 想法 的 优 劣 与 分 支 的 名 称 无 关 ) 。 在 想 要 创 
建 分 支 项 目的 Source Control 荣 单 中 的 子 菜单 中 选择 New Branchhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 束 会 出 现 创建 分 支 的 界面 ， 要 求 填 入 分 支 名 
称 ， 然 后 单 击 Create 按 钮 ， 界 面 融会 显示 一 个 活动 指示 器 ， 分 文 创 建成 功 后 消失 。 现 在 ， 本 地 代码 仓库 已 经 切换 到 了 good- 


idea 这 个 分 支 。 


之 后 ， 她 殊 能 像 往常 一 样 开发 、 测 试 程序 。 同 时 ， 她 也 需要 维护 master 分 支 的 开 友 ，master 中 的 内 容 都 是 最 后 要 面向 用 户 
的 内 容 ， 其 他 开 友 者 都 会 以 master 分 文中 的 工作 为 准 而 进行 协同 开 友 。 使 用 命令 : Source Control 一 working copy 一 Switch 
to Branchhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/AText/.… 惑 能 切换 到 分 文 。 使 用 这 条 命令 后 ， 会 出 现 一 个 
显示 当前 所 有 分 文 的 界面 : 包括 本 地 、 远 程 服 务 器 中 对 她 而 言 全 部 可 以 使 用 的 分 文 。 选 择 master， 然 后 单 击 Switch 按 钮 ， 葡 能 
切换 到 master 分 支 ， 见 图 7.21。 


Switch to branch: 


Local Branches 


Last modified: Yesterday by User B 


origin 


3 master 
| Last modifled: Yesterday by Use 


owiltch from the current branch (good-idea) to the selected branch. 





络 获取 远程 服务 器 中 分 支 的 信息 ， 那 么 这 些 信 息 的 


习 


图 7.21 分支 切 换 界 面 能 显示 本 地 和 远程 服务 器 中 全 部 可 用 的 分 支 ( 若 通过 


显示 需要 花费 一 些 时 间 ) 。 选 择 一 个 分 支 ， 然 后 单 击 Switch 就 会 将 这 个 分 支 中 的 代码 签 出 到 本 地 的 工作 目录 


在 图 7.20 中 ， 这 两 个 分 文中 都 有 很 多 个 版 本 ， 她 上 友 现 如 果 不 合 并 来 目 master 分 文中 的 更 改 ，good-idea 这 个 分 文 的 开 友 无 
法 继续 向 下 进行 。 选 择 Source Control 一 working copy 一 Merge from 
Branchhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/ .开始 合并 操作 。 如 果 她 现在 在 good-idea 这 个 分 
文中 ， 融 可 以 在 分 广 选 择 界 面 中 选择 master 分 文 ， 然 后 单 击 Merge 按 钮 。 或 者 ， 如 果 现 在 处 于 master 分 文中 ， 那 么 需要 选择 
Merge into Branchhttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., AnH szgood-idea, 
选择 任意 一 种 合并 方法 ， 都 会 出 现 合并 对 比 界 面 ， 这 样 她 残 能 查看 所 有 的 更 改 ， 然 后 逐一 选择 需要 合并 的 更 改 。 


在 她 对 新 想法 实现 的 结果 满意 之 前 ，good-idea 分 支 迭 代 了 多 个 版 本 。 现 在 ， 是 时 候 将 good-idea 分 支 中 的 更 改 合并 到 
master 中 了 。 选 择 Merge into Branchhttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 然 后 选择 master 分 支 ， 完 成 最 后 的 合并 。 


7.8 ”小结 


本 草 内 容 非 党 多 ， 但 是 版 本 管理 本 身 涉及 的 知识 束 很 多 ， 掌 握 版 本 管理 的 使 用 将 会 令 人 受益 菲 浅 。 当 创建 第 一 个 项 目的 时 
候 ， 若 勾 选 了 复 选 框 ，Xcode 束 会 目 动 为 你 提供 一 个 Git 代 码 仓库 。 如 果 你 已 经 在 Xcode 服务 器 中 注册 了 一 个 账 尸 ， 甚 至 可 以 利 
用 Xcode 建 y 一 个 新 的 远程 代码 仓库 。 在 本 章 中 ， 你 开始 学 习 使 用 版 本 管理 ， 逐 步 将 工作 提交 到 版 本 库 中 ， 之 后 能 够 对 比 版 本 库 
中 的 版 本 ， 看 看 在 何 时 对 代码 做 了 什么 修改 。 同 时 也 获得 了 一 定 程度 的 宽容 之 心 ， 现 实生 活 中 很 缺少 这 种 金 容 之 心 。 


Xcode 对 Git 和 Subversion 的 文 持 足够 应 对 日 冲 开 友 ， 但 是 它 的 功能 还 不 全 面 。 你 还 需要 研究 使 用 命令 行 完 成 版 本 库 的 管 
理 。 我 也 无 法 在 本 章 中 介绍 更 多 关于 Subversion 和 Git 的 内 容 。 这 些 软 件 包 中 的 命令 行 功能 都 相当 强大 ， 你 至 少 也 应 该 了 解 它 们 
能 完成 哪些 功能 。 这 里 有 一 些 非常 实用 的 资源 : 


Git Pro Git， 最 好 的 Git 从 入 门 到 高 手 的 图 书 ， 可 以 在 http://git-scm.com/book 中 免费 阅读 这 本 书 。 不 过 考虑 到 对 作者 
Scott Chacon 的 支持 ， 请 购买 一 本 纸 质 书 或 者 电子 版 。 





Version Control with Subvetsion， 由 Subvetsion 的 作者 撰写 ， 并 且 每 次 Subvetsion 的 新 版 发 布 时 ， 他 都 会 对 此 





- Subversion 


书 进行 修订 。 在 链接 http://svnbook.red-bean.com/ 中 能 找到 此 书 。 


还 有 一 点 ， 请 了 解 标记 修订 (tagging a revision) 的 思想 ， 它 能 让 你 在 项 目的 版 本 历史 中 标记 对 应 (比如) 及 布 版 本 的 位 
置 。Xcode 版 本 管理 对 标记 功能 的 支持 非常 不 好 。 


我 们 基本 结束 了 对 Xcode 的 介绍 。 现 在 ， 你 已 经 具备 了 一 些 Xcode 的 背景 知识 ， 可 以 继续 向 着 最 初 使 用 Xcode 这 个 工具 的 目 
标 出 友 : 构建 图 形 化 的 OS 和 OS X 应 用 程序 。 


sa abst 10S 应 用 程序 的 生命 周期 


: 第 8 章 ”开始 制作 1OS 应 用 程序 
-PIF iOS 应 用 程序 : 模型 

“ 第 10 章 ”iOS 应 用 程序 : 控制 器 
` 第 11 章 ”构建 新 视图 

` 第 12 章 ”新 视图 的 自动 布局 

` 第 13 章 ”添加 表格 单元 格 

` 第 14 章 添加 编辑 器 


` 第 15 章 ”单元 测 试 


第 8 草 ” 开 始 制作 iOs 应 用 程序 


既然 我 们 已 经 掌握 了 基本 的 拷 术 ， 束 开始 学 习 制 作 一 个 真正 的 产品 。 我 们 将 会 制作 一 款 iPhone 应 用 程序 ， 这 个 应 用 程序 用 
于 管理 四 分 卫 列 表 并 展示 他 们 的 比赛 和 职业 统计 数据 。 


8.1 ”规划 应 用 程序 


在 开始 写 代码 之 前 ， 最 好 (但 并 不 是 必须 ) 知道 你 要 做 什么 。 尤 其 是 要 知道 ， 你 想 要 为 用 己 展 现 什么 、 展 现 这 些 内 容 需 要 什 
么 数据 、 如 何在 数据 和 展示 之 间 相 互 转化 。 


8.1.1 模型 -视图 -控制 蝇 


模型 -视图 -控制 器 (MVC) 设计 模式 将 图 形 应 用 程序 中 的 这 些 问题 转化 为 了 一 种 结构 。Cocoa Touch 应 用 程序 框 染 的 设计 
就 是 用 于 实现 遵循 MVC 模 式 的 应 用 程序 。 如 果 你 不 遵循 这 个 模式 ， 束 会 友 现 上 自己 “正在 和 框 染 作 斗 争 ”: 这 将 导致 完成 一 款 应 
用 程序 相当 困难 ,维护 起 来 也 会 相当 让 人 月 演 。Xcode 开 发 工具 的 设计 支持 Cocoa 编 程 ， 因 此 也 支持 MVC 模 式 。MVC 将 一 蒜 应 
用 程序 的 功能 分 为 3 部 分 ， 应 用 程序 的 任意 一 块 都 必须 能 够 划 入 其 中 的 一 部 分 


` 模型 对 名 包装 特定 问题 域 的 数据 和 逻辑 。 任 意 应 用 程序 的 模型 基本 都 是 独一无二 的 。 你 可 以 创建 NSObject 或 者 
NSManagedObject 的 子 类 ， 为 你 的 模型 创建 自己 的 生命 周期 。 


- 视图 对 象 用 于 处 理 用 户 交 互 操作 ， 展 示 信 息 ， 并 能 让 用 户 操作 数据 或 者 执行 其 他 影响 应 用 程序 行为 的 操作 。 视 图 通 第 继承 
于 一 个 标准 元 素 ， 比 如 说 按钮 、 表 格 、 滚 动容 器 及 文本 框 。 理 想 情况 下 ， 视 图 应 该 不 知道 任何 与 要 解决 的 问题 相关 的 事 : 一 个 按 


钮 仅 需 要 展示 自身 并 对 单 击 事件 做 出 响应 ， 而 不 需要 知道 这 个 单 击 事件 对 应 用 程序 有 什么 影响 。 在 iOS 中 ， 视 图 是 UIView 或 者 它 
任意 子 类 的 一 个 实例 。 


` 控制 器 对 象 将 模式 中 的 逻辑 与 视图 中 的 元 素 结合 在 一 起 。 一 个 控制 器 对 象 决 定 了 视图 如 何 展 示 ， 以 及 如 何 将 用 户 行 为 转换 
为 模式 事件 。 在 iOS 中 ， 控 制 器 通常 是 UIViewControllet 子 类 的 实例 。 


好 吧 ， 在 实际 使 用 中 ， 的 确 有 一 些 内 容 并 不 能 精确 地 划分 到 模式 、 视 图 或 者 控制 器 中 。 如 果 你 有 一 个 目 定 义 的 视图 用 于 展示 
特定 的 数据 ， 并 且 打 算 让 这 个 视图 完全 独立 于 你 的 数据 模块 ， 那 么 它 束 无 法 划分 到 这 3 部 分 中 。 不 过 ，MVC 仍 然 是 一 个 非常 重要 
的 规则 : 如 果 你 想 避 免 使 用 它 ， 那 么 应 该 理解 你 正在 逃避 ， 并 且 考 虑 是 人 否 能 够 恢复 MVC 的 独立 性 。 


8.1.2 模型 


从 passer rating 的 本 质 上 说 ， 你 仅 需要 一 个 模型 类 : 用 于 保存 一 个 传 球 手 姓名 、total attempts, completions, yards, 
touchdowns， 还 有 interceptions 的 Passer 类 。 让 我 们 把 这 件 事 变 得 有 趣 一 点 : 你 想 要 使 用 多 少 attempts 来 计算 rating 都 可 
以 ， 通 常 每 场 比赛 以 及 汇总 统计 都 会 计算 rating 的 值 。 所 以 Passer 应 该 “拥有 ” 任意 数量 的 Game 对 象 ， 它 包含 比赛 的 细节 ( 哪 
天 、 哪 些 人 参与 的 这 场 比赛 等 信息 ) ， 还 有 各 场 比赛 的 传 球 数据 。 


那么 ， 这 个 模型 束 应 该 如 图 8.1 所 示 。 


Game 
Passer 


When Played Attempts 


First Name - 

Our leam Completions 
Last Name 
Our Score Yards 
Current leam 

Their leam Touchdowns 

Games 
Their Score Interceptions 





图 8.1 这 张 图 展示 了 passetf-tating 应 用 程序 需要 提供 什么 数据 才能 展示 所 需 的 内 容 : 一 个 Passef 对 象 仅 表示 单个 参赛 者 ， 他 的 职业 
统计 数据 在 Passef “JAAD” Game 对 象 的 数据 集合 中 


那 传 球 手 的 汇总 统计 一 一 career yards、touchdowns、rating 呢 ?这 些 数据 都 可 以 从 Games 中 剥离 出 来 一 一 这 样 看 起 来 残 
非常 简单 了 。 


8.1.3 ”视图 


iOS 应 用 程序 通常 不 具备 文本 的 概念 ， 但 是 即便 是 最 简单 的 应 用 程序 也 需要 多 个 界面 的 视图 。 你 需要 处 理 传 球 手 及 他 们 的 比 
还 要 能 够 查看 并 且 编 辑 它 们 。 


sit 


你 需要 一 个 传 球 手 列表 ， 这 些 信息 可 以 在 一 个 独立 的 视图 中 创建 和 编辑 ， 同 时 ， 还 需要 一 个 专门 用 于 显示 所 选 传 球 手 的 视 
各 ， 每 一 个 传 球 手 还 对 应 一 个 所 参加 的 比赛 的 列表 视图 ， 这 个 视图 也 需要 能 够 创建 并 编辑 每 场 比 赛 。 图 8.2 显 示 了 数据 流 的 概 
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A8.2 ”这 张 草图 


Passer Rating 这 款 iOS 应 用 程序 的 外 观 和 数据 流 。 这 张 草 图 的 左边 是 一 
。 用 户 可 以 添加 或 者 编辑 传 球 手 (左下 ) 和 游戏 (ET) 的 数据 


会 显示 出 这 位 传 球 手 的 细节 记录 (右上 ) 


Ose x 


一 般 来 襄 ， 


个 传 球 手 的 列表 。 单 击 其 中 的 一 行 就 


这 就 是 Passer Rating 的 完整 视图 ， 将 其 展现 在 纸 上 是 最 基本 的 步骤 。 可 惜 ， 在 我 们 完成 这 个 应 用 程序 之 前 ， 本 书 不 
会 再 介绍 其 他 Xcode 例 子 。 


iOS 应 用 程序 的 每 个 阶段 都 会 展示 一 个 全 屏 的 视图 对 象 一 UIView。 主 视图 一 般 会 包含 其 他 视图 的 结构 。 比 如 
说 ， 草 图 左下 角 的 Passer 编 辑 器 (参考 图 8.2) 包 合 一 个 UIView 的 包 效 器 ， 它 包含 一 个 导航 栏 〈 顶 疹 是 一 个 
UINavigationltem) ， 导 舰 器 有 两 个 按钮 〈 导 舰 栏 的 两 头 各 有 一 个 UIBarButtonltem) 。 它 还 包含 一 个 3 行 


(UlTableViewCell) 的 图 表 (UlTableView) ， 每 一 行 都 有 一 个 标签 (UILabel) 以 及 一 个 文本 输入 框 (UlTextField) 。 


8.1.4 控制 器 


iOS 应 用 程序 由 一 系列 视图 控制 器 组 织 而 成 ， 每 个 对 象 都 继承 于 UIViewController。 每 个 视图 控制 器 会 将 模式 对 象 和 视图 结 
合 在 一 起 ， 然 后 在 设备 的 屏幕 上 展示 。 对 于 每 个 你 在 草图 中 看 到 的 全 屏 视 图 来 说 ， 必 须要 提供 一 个 UlIViewContoller 的 子 类 ， 使 
用 它 将 模式 中 的 数据 与 视图 结合 在 一 起 ， 然 后 显示 在 屏幕 上 。 在 视图 的 生命 周期 中 ， 控 制 器 先 出 现 ， 然 后 初始 化 ， 它 会 创建 或 者 
载 入 视图 对 象 并 将 它们 反映 在 模式 中 。 


现在 ， 即 便 是 一 个 像 这 样 包 仿 4 个 主 视图 滑 入 或 者 滑 出 的 简单 应 用 程序 ， 都 要 遵循 MVC 这 个 结构 。 管 理 这 些 视图 的 关系 
一 一 何 时 在 屏幕 上 出 现 ， 何 时 再 从 屏幕 上 消失 一 一 看 起 来 是 一 个 非常 复杂 的 任务 ， 当 然 ， 这 也 的 确 是 一 个 复杂 的 任务 。 但 是 ， 
好 在 你 不 需要 对 这 个 复杂 的 任务 过 于 担心 。UIKit、iOS 中 的 用 户 界 面 组 件 提供 了 umbrella 视 图 控制 器 (比如 
UlNavigationController) ， 它 能 通过 接管 控制 器 对 象 帮助 你 管理 导航 任务 。 你 需要 做 的 殊 是 在 切换 视图 的 时 候 友 起 一 个 视图 切 
损 请 求 ， 这 个 umbrella 控 制 器 会 帮 你 完成 余下 的 工作 。 


wits iPhone 6 Plus 的 屏幕 大 小 介 于 iPad 和 非 iPhone plus 之 间 。 在 iOS 8 中 ，Apple 引 入 了 一 个 方法 ， 防 止 iPad 中 主 视 图 和 细 
节 视 图 从 挨 着 的 结构 在 小 屏幕 上 转换 为 两 个 界面 的 结构 。 这 是 一 项 激动 人 心 的 特性 ,但 是 对 于 Xcode 的 工作 流 没有 什么 影响 。 


8.2 ”开始 制作 一 个 全 新 的 IO9 项 目 


选择 File 一 New 一 Projecthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (ĈN) ， 创 建 一 个 全 新 的 Xcode 项 目 。 在 iOS 
下 选择 Application， 然 后 在 应 用 程序 类 型 列表 中 选择 Master-Detail 应 用 程序 。Passer Rating 遵 循 最 常见 的 展示 列表 和 细节 视 
图 的 模式 ， 在 导航 栏 下 有 一 个 breadcrumb， 能 回溯 整个 树 结 构 。Master-Detail 应 用 程序 是 这 种 应 用 程序 的 框架 模板 。 然 后 单 
击 Next 按 钮 。 


下 一 个 New Project assistant 面 板 能 让 你 将 这 个 项 目 命名 为 Passer Rating。 这 个 很 简单 。 


下 一 个 条 目 是 Organization Name， 每 当 Xcode 创 建 了 一 个 新 文本 文件 ， 其 中 吏 会 包 合 版 权 声 明 ， 一 般 情况 下 ， 版 权 属 于 
文件 所 有 者 。 


Organization ldentifier 是 下 一 个 文本 域 。iOS (以 及 OS X) 中 的 每 一 个 应 用 程序 都 有 一 个 全 局 唯一 的 字符 串 。Passer 
Rating 这 个 应 用 程序 也 需要 这 样 一 个 字符 串 。 自 定义 生成 全 局 唯一 标识 符 的 方法 是 : 将 域名 反 过 来 ， 添 加 一 个 点 号 ， 后 面 接 上 
应 用 程序 的 名 字 ， 并 针对 OS 进行 合理 编码 。 我 有 一 个 域名 是 wt9t.com， 所 以 这 个 地 方 填 com.wt9t。 


PTR ”如果 你 没有 一 个 属于 自己 的 域名 ， 那 就 相当 于 告诉 我 你 连 一 件 T 恤 都 没有 。 弄 一 个 域名 ， 很 便宜 ， 仅 需 这 个 域名 
即 可 ， 不 需要 其 他 的 东西 。 


Xcode 为 你 生成 了 一 个 标识 字符 串 : com.wt9t.Passer-Rating， 这 个 字符 串 在 显示 在 company IDFA. 


Language 弹 出 菜单 允许 你 选择 Swift 或 者 Objective-C 作 为 主要 的 编程 语言 。 也 可 以 在 同一 个 项 目 中 混合 使 用 两 种 语言 ， 详 
情 见 Apple 的 官方 文档 。 我 们 这 个 项 目 使 用 纯 Swift。 


Devices (设备 ) 决定 模板 是 否 应 该 包含 应 用 于 iPhone、iPad 或 者 包含 两 者 的 Ul 部 分 ， 它 能 让 屏幕 适 配 很 方便 。 


最 后 ， 勾 选 Use Core Data 这 个 复 选 框 。Core Data 用 于 Cocoa 的 对 象 持 久 化 以 及 对 应 框架 ， 它 能 让 数据 库 的 组 织 很 方便 。 
项 目 模 板 会 基于 应 用 程序 的 运行 添加 一 系列 快捷 方法 获取 Core Data。 在 这 个 简单 的 项 目 中 ， 我 们 会 用 到 Core Data, 


单 击 Next 按 钮 ， 将 会 看 到 一 个 文件 夹 选择 界面 ， 残 像 你 在 第 2 章 中 见 到 的 那个 一 样 。 选 择 一 个 合适 的 位 置 ， 然 后 确保 将 
Source Control 设 置 为 创建 一 个 本 地 (My Mac) Git 代 码 仓库 。 


单 击 Create 按 钮 ， 将 项 目 窗口 恢复 到 之 前 的 样子 ， 你 将 再 一 次 见 到 Target 编 辑 器 。 


Wits 如 果 这 个 项 目 想 要 包含 Objective-C 类 ， 那 么 需要 在 File inspectot 中 的 Project Document 部 分 指定 一 个 Class Prefixo "T 
能 需要 3 个 字母 (现在 已 经 不 推荐 使 用 两 个 字母 作为 前 级 了 ) 用 于 Xcode 的 类 模板 ， 将 它 放 在 类 名 的 前 面 。Objective-C 中 没有 命名 
空间 ， 如 果 你 选择 一 个 “常见 的 ”名 字 作 为 类 名 ， 那 么 很 可 能 与 Cocoa 或 者 第 三 方 库 中 的 类 名 发 生 冲突 。 如 果 有 冲突 ， 构 建 过 程 
可 能 会 停止 在 链接 阶段 ， 如 果 在 链接 阶段 没有 发 现 这 个 错误 ， 那么 之 后 可 能 会 出 现 非常 难以 排查 的 错误 。 在 类 名 前 加 上 一 个 前 组 
可 以 最 大 化 地 降低 这 种 问题 的 发 生 概率 。 


Target 编 辑 器 


Passer Rating 这 个 项 目 包含 两 个 targets: Passer Rating， 它 能 生成 对 应 的 应 用 程序 ; 还 有 一 个 是 Passer RatingTest, € 
包含 应 用 程序 的 测试 套件 。Xcode 首 先 显 示 的 是 Passer Rating 这 个 target 的 通用 编辑 器 ( 单 击 Project navigator] 页 端的 Passer 
Rating 条 目 ， 能 看 到 这 个 项 目的 详细 信息 ) 。 它 提供 了 确认 项 目 基 本 设置 的 接口 
在 哪里 能 找到 UIKit 在 应 用 程序 中 显示 的 图 片 。 它 也 保存 了 这 个 target 链 接 时 用 到 的 库 列 表 。 





标识 符 、target 环 境 、orientations， 以 及 


请 注意 一 下 Deployment Info 这 部 分 中 的 Deployment Target 域 : 这 个 地 方 用 于 指定 应 用 程序 所 能 运行 的 操作 系统 的 最 低 
版 本 值 。 应 用 程序 无 法 在 低 于 这 个 版 本 的 操作 系统 上 运行 ， 同 时 也 可 以 放心 使 用 这 个 版 本 的 操作 系统 提供 的 所 有 功能 。 项 目 模板 
会 将 这 个 值 设置 为 最 新 的 版 本 ( 当 我 撰写 本 书 时 ， 最 新 版 本 为 8.2) 。 我 们 将 要 使 用 一 些 iOS 8 特定 的 功能 ， 所 以 保持 这 个 选项 不 


ZR 
DL o 


还 有 另外 一 个 概念 : SDK, Build settings 选 项 卡 中 能 找到 已 。 按 照 Xcode 的 说法 ，SDK 是 包含 头 文件 、 库 文件 ， 以 及 其 
他 资源 的 树 形 目录 ，SDK 能 让 你 使 用 特定 版 本 OS 的 特定 功能 。 以 前 Xcode 提供 一 个 开发 包 向 后 兼容 早 版 本 的 应 用 程序 ， 但 是 现 
在 ， 你 仅 能 得 到 包含 最 新 的 iOs 的 SDK， 并 且 Xcode 仅 仅 能 运行 于 最 新 的 一 两 个 版 本 的 OS XE. 


尽管 你 已 经 无 法 选择 SDK 的 版 本 ， 但 是 你 也 应 该 记 住 这 一 条 : target 的 版 本 是 应 用 程序 能 够 运行 要 求 的 操作 系统 的 最 低 版 
本 ，SDK 版 本 是 保证 应 用 程序 功能 正常 的 最 低 版 本 。 如 果 你 打算 向 前 兼容 iOS 5.1， 那 么 将 target 设 置 为 5.1， 使 用 当前 的 SDK。 
同时 也 要 记 住 不 要 使 用 任何 ?5.1 之 后 版 本 的 任何 功能 ， 这 样 构建 系统 链接 应 用 程序 的 时 候 ， 融 不 会 要 求 使 用 最 新 的 API 才 能 运行 。 


5S 注意 ”同样 ， 如 果 你 将 target 中 OS 的 版 本 设置 得 比 SDK 要 求 的 OS 版 本 低 ， 那 么 构建 系统 将 会 使 用 老 版 本 OS 的 行为 ， 即 便 
你 的 应 用 程序 将 会 使 用 对 应 OS 版 本 提供 的 功能 。 





最 新 的 SDK 可 能 已 经 修改 了 一 些 bug 并 添加 了 部 分 新 特性 


8.3 ”项 目 中 都 包谷 什么 


你 为 Passer Rating 选 择 的 项 目 模 板 中 包含 的 内 容 有 很 多 。 


Sts 如 果 你 没 看 到 Navigator 区 域 ， 单 击 工具 栏 最 右 侧 的 按钮 ， 就 会 在 窗口 的 左边 出 现 一 个 条 形 栏 ，Project navigators at 


于 这 个 条 形 栏 的 第 一 个 选项 卡 中 。 


- Class PRAppDelegate: 应 用 程序 本 身 其 实 就 是 类 UIApplication 的 一 个 对 象 ， 你 无 法 继承 或 者 替换 这 个 类 。 委 托 模式 在 Cocoa 
七 架 中 广泛 使 用 ， 应 用 程序 特有 的 方法 都 来 自 委 托 对 象 中 的 方法 ， 这 些 方法 都 需要 通过 应 用 程序 对 象 调用 。PRAppDelegate 是 
UIResponder 的 一 个 子 类 ， 还 实现 了 UIApplicationDelegate 协 议 (这 个 协议 能 够 保证 包含 UIApplication 需 要 的 方法 ) 。.swift 文 件 的 
模板 包含 了 管理 应 用 程序 生命 周期 的 方法 ， 其 中 就 包括 构建 Core Data 数 据 库 。 


Main.storyboard: storyboard 是 用 户 界 面 布 局 的 图 形 化 显示 ， 它 相当 于 在 程序 各 个 界面 之 上 又 增加 了 一 层 。 这 个 项 目 从 开始 
到 结束 都 会 与 它 相 关 。 


- XPRMasterViewController: 正如 类 名 所 示 ， 它 是 Passef Rating 主 ( 根 级 别 root-level) 视图 的 控制 器 ， 这 个 类 中 会 包含 传 球 手 
的 姓名 以 及 评分 的 表 。 因 为 基于 导航 (navigation-based) 的 应 用 程序 大 部 分 初始 界面 都 是 一 张 表 ， 所 以 这 个 模板 让 
MasterViewControllet 继 承 于 UITableViewConttoller， 这 个 类 非常 适合 实现 表 视 图 。 实 现 文件 中 包含 一 些 填 充 表 需要 的 方法 。 它 同样 


提供 了 NSFetchedResultsController 的 实例 ， 这 个 实例 实现 了 很 多 桥接 Core Data 数 据 与 各 种 表 的 功能 。 


类 DetailViewControlletr: 这 个 控制 器 用 于 Passer Rating 的 下 一 层 ， 当 单 击 传 球 手 姓名 的 时 候 ， 就 会 看 到 这 个 控制 器 。 模 板 将 
声明 为 UIViewController 的 一 个 简单 子 类 。 


- Images.xcassets: 它 是 iO 〇 OS 运行 一 款 应 用 程序 所 需要 的 最 小 的 图 片 集合 。 首 先是 Applcon， 正 如 你 想 的 一 样 ， 它 用 于 应 用 程 
序 的 图 标 显示 。 由 于 屏幕 尺寸 、UI 配 置 及 分 辨 率 的 变化 ， 以 及 一 些 人 为 因素 ， 导 致 Xcode 积 聚 了 大 量 的 图 片 ， 其 中 有 很 多 都 已 过 
时 。 资 源 目录 将 这 些 图 片 封 装 起 来 ， 放 入 一 个 单独 的 项 目 中 ， 并 提供 了 获取 资源 的 入 口 。 应 用 程序 查找 资源 的 时 候 ， 仅 需要 通过 
名 字 查 找 ， 资 源 目 孙 机 制 就 会 自动 提供 与 当前 环境 最 匹配 的 资源 。 


如 果 你 想 要 将 应 用 程序 运行 在 iDS 7 或 者 更 早 的 操作 系统 版 本 上 ， 那 么 还 需要 一 个 LaunchlImage (不 要 将 它 称 之 为 启动 界 
面 ) ， 它 会 显示 在 应 用 程序 启动 和 正常 工作 之 间 的 那 一 小 段 时 间 中 。 单 击 图 片 集 列表 的 + 按钮 ， 命 名 为 LaunchImase ， 然 后 在 
Target 编 辑 器 的 General 选 项 卡 中 注册 集合 的 名 称 。 


- LaunchScreenxib 替 换 了 LaunchImage 和 图 片 集 。 它 是 一 个 在 启动 的 时 候 显示 的 Interface Builder 界 面 布局 。 因 为 界面 中 的 布局 
(应 该 ) 能 适 配 任何 界面 大 小 、 朝 向 和 分 辨 率 ， 你 不 用 为 每 种 可 能 的 组 合 都 提供 对 应 的 图 片 。 这 个 模板 为 你 提供 了 统一 的 布局 ， 
包括 应 用 的 名 称 和 版 权 信息 ; 你 应 该 将 其 与 你 的 应 用 程序 实际 的 初始 化 外 观 适 配 。 如 果 没 有 提供 一 个 启动 布局 ，iOS 会 使 用 一 张 
启动 图 片 ， 如 果 有 必要 ， 还 会 “缩放 ”已 经 存在 的 UI 来 适 配 屏幕 的 大 小 。 更 多 11 章 和 第 12 章 。 


- Passer_Rating.xcdatamodeld: Core Data 并 未 提供 完整 的 数据 库 服务 ， 不 过 如 果 你 有 一 些 SQL 的 背景 知识 ， 那 对 于 数据 分 析 很 
HA Bho Data Model 文 件 等 同 于 SQL 中 的 schema。 它 定义 了 持 有 数据 的 入 口 (想象 一 下 “ 表 ”) ， 还 有 属性 (想象 一 
下 列 ) 。 它 也 在 入 口 之 间 (想象 一 下 “再 也 不 用 看 到 连接 表 ”) 建立 了 一 对 多 和 多 对 多 的 关系 。Xcode 针 对 数据 模型 提供 了 
图 形 化 的 编辑 器 。 


- Passer Rating-Info.plist 在 Supporting File 组 中 : 它 是 座 入 在 应 用 程序 中 的 一 个 源 文件 。 这 个 文件 提供 了 应 用 程序 的 一 些 基 本 
信息 ， 包 括 应 用 程序 的 用 途 、 能 够 处 理 的 数据 以 及 应 用 程序 在 主 界面 上 如 何 显示 。 部 分 信息 是 用 纯 文 本 的 方式 展现 在 用 户 


所 以 其 中 的 内 容 包 含 了 InfoPlist.strings 中 针对 用 户 所 使 用 语言 的 内 容 ( 见 第 21 章 ， 该 章 会 介绍 OS X 中 的 本 地 化 ， 不 过 其 中 大 部 分 
内 容 也 适用 于 iOS) o 


PER ”Objective-C 项 目 可 能 也 包含 一 个 作为 可 执行 文件 入 口 的 main.m 文 件 ，Passer Rating-Prefix.pch 构 建 了 用 于 编译 ObjC 类 


文件 的 符号 。 而 Swift 不 需要 这 些 
- Target “Passer RatingTest” 中 有 一 个 类 文件 ， iX target 中 的 Info. plist 文 件 与 应 用 程序 target 中 的 Info. plist 文件 类 似 。 


EE 老 版 本 的 Objective-C 项 目 会 包含 一 个 框架 组 ， 用 于 展示 链接 到 应 用 程序 中 的 系统 和 第 三 方 库 。 现 在 基本 已 经 不 再 


需要 ， 但 是 Swift 和 Objective-C 依 赖 导 入 模块 ， 这 些 模块 中 有 预 编译 的 符号 并 会 目 动 链接 。 
Xcode 的 项 目 模 板 中 也 包谷 了 大 量 的 构建 设置 ， 这 些 配置 指定 了 Pass Rating 如 何 编译 、 链 接 和 组 织 。 


就 目前 而 言 ， 这 个 项 目 一 切 正常 。 运 行 它 : 选择 Product 一 Run (R) 


，Xcode 束 会 构建 这 个 应 用 程序 ， 几 秒 过 后 ，iOS 模 
拟 器 就 会 启动 并 载 入 Passer Rating。 从 另 一 个 角度 讲 


， 这 个 应 用 程序 与 .OS 上 使 用 Core Data 制 作 的 “Hello World” 类 似 : 带 
有 Edit 和 + 按钮 的 导航 栏 下 有 一 个 空 表格 。 单 击 + 按钮 ， 就 能 增加 一 行 带 有 当前 时 间 的 行 。 单 击 新 建 的 这 一 条 信息 


T, MAH 
入 “详情 ”视图 。 根 列表 上 的 Edit 按 钮 (或 者 在 指定 行 上 滑动 ) 能 用 来 删除 对 应 行 。 关 闭 应 用 程序 ， 重 新 打开 你 会 友 现 刚 删 除 的 
这 些 行 还 会 出 现 ， 见 图 8.3。 
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Carne "T fel PA 


“I 


Done Master 


@ 201 


4-07-14 19:20:31 +... 









-07-14 19:20:54 





图 8.3 这 些 简单 的 代码 来 自 于 Cote Data 和 Masteft-DetailApplication 项 目 模板 ， 这 已 经 足够 制作 一 个 能 在 iDOS 模 拟 器 上 运行 的 程序 。 


它 能 在 表 中 添加 行 ， 而 且 正如 显示 的 那样 ， 它 也 能 让 Edit 按 钮 做 出 删除 指定 行 的 响应 


8.4 人 小结 


在 本 草 中 ， 我 们 开始 学 习 制 作 iOS 应 用 程序 。 在 开始 正式 使 用 Xcode 工作 之 前 ,我 们 确定 了 这 款 应 用 程序 的 用 途 以 及 外 观 。 


一 旦 想 明 白 这 些 ， 就 可 以 使 用 Xcode 创建 项 目 。 探 索 了 Project 编 辑 器 ， 学 习 了 它 如 何 管理 应 用 程序 本 身 的 配置 。 然 后 又 开 
台 学 习 Xcode 提 供 的 项 目 模板 。 


Xcode 提供 的 “ 空 ”项 目 也 可 以 运行 ;你 会 友 现 ， 运 行 这 个 空 项 目的 时 候 会 局 动 iOS 模 拟 器 ， 在 这 个 模拟 器 中 你 能 使 用 这 个 
应 用 程序 。 


现在 ,你 已 经 准备 好 了 以 这 个 空 项 目 为 基础 ， 开 发 你 目 己 的 应 用 程序 ， 实 现 本 草 开始 时 做 的 设计 。 我 们 先 从 模型 开始 。 


第 9 草 ”10S 应 用 程序 : 模型 


现在 ， 是 时 候 在 Passer Rating 这 个 项 目的 数据 设计 中 添加 一 些 新 内 容 了 。1iOS 和 OS xX 平台 上 的 Core Data 框 架 提供 了 管理 
对 象 关系 图 的 强大 系统 ， 并 能 将 它们 持久 化 到 SQLite 数 据 库 中 。 


Wis SQLite (如 果 你 能 忍受 ess-cue-light 和 see-kwel-light， 那 么 你 会 完 得 SQLite 是 一 个 优雅 的 工具 ) 是 一 个 拥有 SQL 数据 
库 全 部 功能 的 库 和 命令 行 工 具 ， 它 是 Core Data 的 基础 。Core Data API 对 底层 并 不 了 解 (在 OS 义 中 ， 底 层 实现 有 两 种 方式 ) ， 而 且 


它 也 无 法 直接 访问 底层 数据 库 。 这 个 库 是 :OS 和 OS X 的 标准 组 件 。 详 情 见 http:/ /sglite.org。 


Xcode 包含 对 Core Data 最 基本 的 支持 。 在 本 章 中 ， 你 将 会 看 到 如 何 使 用 Xcode 的 图 形 编辑 器 将 数据 设计 转换 成 可 执行 的 数 
据 模 型 。 


9.1 ”实现 模型 


Core Data 将 会 为 你 存储 模型 对 象 并 记录 它们 之 间 的 关系 。 为 了 做 到 这 一 点 ， 它 需要 一 个 托管 对 象 模型 (managed-object 
model) ， 这 个 模型 规定 了 数据 存储 中 都 有 什么 实体 ， 以 及 它们 所 拥有 的 属性 和 关系 。 在 一 个 完整 的 应 用 程序 当中 ， 它 会 被 保存 
在 一 个 .mom 文 件 中 ， 这 个 文件 的 读 取 效率 很 高 ， 不 过 肉眼 不 可 读 。 对 于 开发 来 说 ， 你 将 会 修改 Xcode 中 的 一 个 数据 模型 文件 

(.xcdatamodel) ， 这 个 文件 将 所 有 信息 用 图 形 的 方式 展现 ， 其 格式 与 图 8.1 所 示 的 模型 概略 图 类 似 。 


Site 随 着 应 用 程序 的 不 断 升 级 ， 数 据 模 型 也 在 持续 更 新 。 用 一 种 托管 对 象 模型 创建 的 数据 文件 与 用 另外 一 种 托管 对 象 
模型 创建 的 数据 文件 并 不 兼容 。Cote Data 提 供 了 一 种 技术 ， 如 果 具 备 完 整 的 模型 序列 ， 那 么 能 让 新 模型 读 取 旧 模 型 创建 的 数据 。 
各 种 模型 创建 的 .mom 文 件 都 保存 在 文件 夹 中 一 一 .momd 文 件 用 于 运行 时 ，.xcdatamodeld 用 于 Xcode。 


9.1.1 实体 


在 Project navigator 中 选择 Passer Rating.xcdatamodeld, Data Model 编 辑 器 分 为 两 部 分 。 左 边 这 一 列 将 模型 中 最 顶级 
的 内 容 列 举 出 来 ， 主 要 是 实体 。 实 体 摘 述 了 Core Data 数 据 库 中 的 独立 记录 。 如 果 你 熟悉 SQL 数 据 库 ， 那 么 会 友 现 尼 与 表 很 像 。 


模板 中 提供 的 模型 非常 简单 ， 只 有 一 个 实体 : Event。 如 果 在 编辑 器 中 选中 它 ， 你 会 在 3 个 表 中 看 到 它 的 属性 (如 果 你 看 不 
到 这 些 表 ， 请 确保 右 下 角 的 Editor Style 控件 选中 的 是 第 一 个 区 段 ， 也 残 是 表 布 局 ) 。 


- Attributes (属性 ) 包含 简单 的 数据 ， 如 : 字符 串 、 日 期 和 数字 等 。Event 有 一 个 属性 timeStamp， 从 上 面 的 表 中 可 以 看 到 它 
的 类 型 为 Date。 

- Relationships (关系 ) 用 一 对 一 、 一 对 多 、 多 对 多 的 方式 将 实体 链接 在 一 起 。Cote Data 维 护 这 些 关 系 ， 你 不 用 操心 键 值 或 
者 连接 。 

- Fetched Properties ( 抓 取 属 性 ) 定义 了 抓 取 请 求 (查询 符合 搜索 要 求 的 对 象 ) 。 这 种 关系 并 没有 随 着 数据 库 的 变化 而 持续 


更 新 。 为 了 获取 当前 的 对 象 集合 ， 不 得 不 亲自 执行 抓 取 操 作 。 抓 取 属 性 有 专门 的 用 途 ， 但 是 这 个 项 目 不 会 用 到 它 。 


单 击 Editor Style 控件 的 右 半 边 ， 碍 看 模型 的 其 他 视图 。 这 个 操作 能 让 你 看 到 整个 模型 图 ， 在 这 个 视图 中 ， 每 个 实体 用 一 个 
方 框 表示 ， 这 些 方 框 里 有 该 实体 对 应 的 属性 和 天 系 。 现 在 这 个 模型 图 中 只 有 一 个 实体 ， 实 体 仪 包含 一 个 属性 ， 所 以 模型 图 看 起 来 
吸引 力 不 大 。 


让 我 们 添加 一 些 内 容 。 切 换 到 之 前 的 Table 风 格 ， 选 中 Event 实 体 ， 然 后 按 Delete 键 。 现 在 开始 添加 自己 要 用 的 实体 。 碍 看 
图 8.1， 你 需要 两 个 实体 : Game 和 Passer。Game 中 的 内 容 比较 有 意思 ， 所 以 让 我 们 从 它 开 始 。 


1) 编辑 器 底部 的 工具 条 有 两 个 圆 形 的 + 按钮 ， 如 果 仔 细 看 ， 你 会 友 现 三 角 图 标 其 实 是 一 个 下 拉 菜 单 的 锁 点 。 每 个 都 能 添加 
多 种 属性 。 现 在 要 添加 的 是 一 个 用 于 比赛 的 实体 。 


单 击 + 按 钮 ， 然 后 选择 Add Entity， 之 后 一 个 名 为 Entity 的 实体 融会 出 现在 编辑 器 的 实体 栏 中 。 双 击 列表 中 实体 名 残 可 以 执 
行 名 称 编辑 操作 ， 将 它 命名 为 Game。 


2) Game 将 会 指 同 Passer， 所 以 即使 我 们 还 没有 正确 地 填充 ， 它 也 应 该 处 于 模型 事件 中 。 再 次 单 击 Add Entity (ERE 


用 的 按钮 )， 将 实体 命名 为 Passer。 


9.1.2 属性 


现在 ,已 经 拥有 了 Game 和 Passer 这 两 个 实体 ， 但 是 它们 没有 包含 任何 数据 。 实 体 是 简单 数据 的 集合 ， 这 些 数 据 束 是 属性 。 


1) 保持 Game 的 选中 状态 ， 单 击 Attributes 列 表 下 面 的 + 按钮 。 表 中 融会 出 现 一 个 新 的 属性 ， 并 且 属 性 名 已 经 处 于 可 编辑 状 


zx 


/Po 


2) 将 这 个 新 属性 命名 为 whenPlayed。 你 发 现 whenPlayed 属 性 的 Type 列 为 Undefined 类 型 。 这 并 不 是 你 想 要 的 结果 ， 不 
过 我 们 马上 融会 解决 这 个 问题 。 


3) 创建 更 多 属性 : attemptes, completions, interceptions, ourScore, ourTeam, theirScore, theirTeam, 


touchdowns, i#@yards, 


SFS 记 住 ， 当 完成 名 字 的 修改 时 ， 要 按 Return 键 。 如 果 你 在 棕 Return 键 之 前 ， 又 添加 了 另外 一 个 属性 (依赖 于 你 的 操 
ME) ，Xcode 会 放弃 之 前 那 条 属性 名 的 修改 ， 导 致 名 称 还 是 atttibute。 


4) 工具 栏 中 的 状态 栏 区 域 会 出 现 错误 提示 ， 因 为 这 些 属性 都 没有 类 型 。 让 我 们 指定 这 些 属 性 的 类 型 。 首 移 从 whenpPlayed 


开始 : 在 Type 列 中 选择 Date 这 个 类 型 。 


5) “标量 类 型 ”说明 不 是 用 于 摘 述 属性 。 单 击 View 控 件 石 人 出 (工具 栏 最 右 侧 ) 打开 Utility 区 域 。Utility 区 域 被 分 隔 成 上 下 
两 部 分 ， 上 面 是 Inspector， 下 面 是 Library。 向 下 拖 外 Library 区 域 的 上 边栏 ， 让 Inspector 尽 可 能 地 显示 更 多 ， 单 击 第 三 个 选项 


卡 ， 显 示 Data Model inspector。 


6) 在 Attributes 列 表 中 选择 yards， 这 个 属性 对 应 的 信息 就 会 显示 在 inspector 中 ， 见 图 9.1。 
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图 9.1 Data Model 查 看 器 ， 图 中 显示 的 是 Game 中 yards 的 属性 。 这 是 设置 属性 类 型 的 另外 一 种 方法 ， 它 允许 你 设置 让 Core Datake 
何 处 理 这 个 属性 的 详细 信息 


Inspector 由 3 部 分 组 成 ， 首 先是 Attribute， 这 也 是 最 有 意思 的 一 个 部 分 ， 它 的 名 字 是 yardqs。Properties 复 选 框 反 映 了 Core 
Data 如 何 存 储 属 性 数据 。 保 持 Transient (这 个 属性 可 能 会 出 现在 模型 中 ， 但 它 不 是 常 驻 属性 ) 和 Indexed (Core Data 会 通过 
yards 迅 速 获 得 Game 对 象 ) 为 未 选中 的 状态 。 取 消 选择 Optional， 这 说 明 如 果 不 计算 获得 的 yards， 那 这 条 比赛 记录 不 能 算是 一 


个 完整 的 记录 。 


在 第 二 部 分 中 ， 将 Attribute Type 设置 为 Integer 32， 它 的 范围 是 -210~210。 当 将 它 设置 为 Integer 32 的 时 候 ，Validation 
区 域 会 要 求 为 这 个 属性 设置 Minimum (最 小 值 ) 、Maximum (最 大 值 ) 和 Default (AE) 。Core Data 拒 绝 保存 一 个 起 出 
范围 限制 的 对 象 。 如 果 要 创建 必 有 属性 (attribute mandatory) ， 最 好 让 Core Data 将 它 初始 化 为 一 个 合法 值 。 对 于 新 记录 来 
说 ，0 是 一 个 很 好 的 选择 。 要 开启 一 个 默认 值 (本 项 目的 做 法 ) 或 者 验证 (我 们 不 想 这 样 做 ) ， 请 勾 选 对 应 的 复 选 框 。 


DE 有 一 个 观点 需要 注意 ， 如 果 没 到 开发 过 程 的 晚期 ， 最 好 不 要 创建 必 有 属性 ， 或 者 设置 验证 条 件 。 如 果 你 尝试 保存 
一 个 包含 必 有 属性 的 对 象 ， 或 者 任何 不 符合 范围 的 对 象 ，Core Data 都 会 报错 。 如 果 代 码 未 完成 ， 你 可 能 不 会 将 所 有 的 值 都 设置 完 


已 
FF 


第 三 部 分 是 Advanced， 它 与 系统 级 的 Spotlight 搜 索 特性 相关。Spotlight 框 显示 用 于 索引 的 属性 。Store in External 
Record File 用 于 Mac 应 用 程序 ， 比 如 Mail， 它 将 信息 保存 在 一 个 Core Data 中 用 于 自己 使 用 。 但 是 还 想 将 它们 记录 到 文件 (每 
个 记录 一 个 文件 ) 中 用 于 spotlight 搜 索 。 


User Info 部 分 能 让 你 添加 各 种 喜欢 的 信息 ， 这 些 信息 都 是 键 - 值 的 形式 ， 用 于 摘 述 这 个 属性 。 因 为 我 们 不 需要 研究 数据 库 的 
元 数据 ， 所 以 可 以 忽略 这 部 分 。Versioning 为 Core Data 做 出 了 备注 ， 如 果 你 想 要 重新 安排 数据 库 的 结构 一 一 如 果 可 以 ， 它 会 
动 将 数据 迁移 到 新 的 结构 。 现 在 可 以 忽略 这 一 操 。 





刚 填写 的 都 是 关于 yards 的 内 容 ， 还 有 另外 6 个 整 型 属性 需要 填充 。 这 看 起 来 很 床 烦 。 我 们 有 一 个 好 方法 : 单 击 attempts， 
然后 按 command 键 ， 同 时 单 击 completions、interceptions、ourScore、theirScore 及 touchdowns， 现 在 选中 了 要 设置 为 整 
型 的 6 个 属性 。 


将 注意 力 放 到 Data Model inspector E, RLA AFERE: 不 可 选 ，32 位 整 型 ， 默认 数值 ， 最 小 值 为 0。 这 样 束 为 这 6 
个 属性 设置 好 了 对 应 的 信息 。 


ourTeam 和 theirTeam 这 两 个 属性 应 该 是 必 选 的 字符 串 ， 勾 选 Min Length 杠 ,设置 一 个 最 小 长 度 ，10 个 字符 或 者 骨 多 点 。 
现在 设置 好 了 Game 对 应 的 属性 ， 也 要 对 Passer 执 行 相同 的 操作 ， 它 市 有 3 个 必 填 的 字符 串 属性 ，firstName、lastName 及 


currentTeam。 根 据 你 自己 的 判断 为 它们 添加 默认 值 和 验证 条 件 。 


9.1.3 关系 


在 现在 为 止 ， 数 据 模型 还 不 是 很 实用 。 你 能 仓储 和 枚 举 Passers 和 Games， 但 是 四 分 卫 参 与 了 比赛 ，Game 是 唯一 持 有 四 分 
卫 实 际 表现 数据 的 对 象 。Core Data 将 两 个 实体 之 间 的 联系 称 为 关系 (relationship) 。 


1) 确保 选中 了 Passer 实 体 。 一 开始 传 球 手 可 能 没有 任何 比赛 记录 ， 但 是 后 面 会 参加 很 多 比赛 。 点 开 右 手边 的 + 按钮 ， 在 弹 
出 的 下 拉 菜 单 中 选中 Add Relationship。 在 Relationships 表 单 中 单 击 + 按钮 ， 或 者 选择 Editor 一 Add Relationship， 一 个 新 的 实 
体 束 会 出 现在 Relationships 列 表 中 。 


wits 如 果 你 没有 看 到 新 建 的 relationship, Af A 7744 tKRelationships#p AF WN RRA A CARF. 


当 你 不 知道 在 编辑 器 中 执行 何 种 操作 的 时 候 ， 请 查看 Editor 菜 单 ， 它 会 根据 当前 使 用 的 编辑 器 类 型 显示 不 同 的 命令 ， 所 以 这 


里 的 命令 会 经 常 更 的。 现在 可 以 使 用 的 命令 可 能 与 你 上 次 打开 这 个 菜单 时 看 到 的 命令 不 同 。 


2) 将 这 个 关系 命名 为 games (将 关系 命名 为 相关 实体 的 名 字 是 一 个 很 好 的 做 法 ， 如 果 关 系 是 一 对 多 ， 那 么 这 个 命名 最 好 是 
复数 形式 ) 。 

3) 在 Relationships 表 的 Destination 列 中 从 弹出 菜单 中 选择 Game 实 体 。Game 现 在 还 没有 任何 关系 ， 所 以 不 需要 在 
Inverse 列 做 任何 操作 。 


4) 返回 Data Model inspector， 现 在 它 已 经 开始 显示 关系 的 选项 。 上 面 的 条 目 反映 了 你 从 表 中 做 出 的 选择 ， 所 以 可 以 不 用 
管 它们 。 勾 选 Optional， 因 为 传 球 手 可 能 还 没 开始 打 比 赛 。 


5) Type 要 选择 To Many， 因 为 一 个 传 球 手 可 能 会 打 多 场 比 赛 (注意 ，Core Data 会 在 无 提示 的 情况 下 处 理 记录 1D 和 外 
键 ) 。 


6) 还 有 一 个 Ordered 复 选 框 。 一 般 来 说 ， 对 象 的 一 对 多 关系 用 集合 来 表示 ， 其 中 唯一 对 象 的 排列 万 式 为 无 序 。 义 选 
Ordered 使 之 成 为 有 序 集合 ， 类 似 于 数组 ， 它 的 元 素 都 有 一 个 固定 的 顺序 ; 也 有 集合 的 特点 ， 其 中 的 元 素 都 不 能 出 现 多 次 。 


本 例 中 相关 对 象 没有 固定 的 顺序 ， 也 没有 特别 的 顺序 需求 。 关 系 的 顺序 按照 表现 的 好 坏 排列 ， 所 以 我 们 不 用 勾 选 这 一 项 。 


7) 不 需要 设置 最 大 值 或 者 最 小 值 ， 因 为 关系 是 可 选 的 ， 所 以 最 小 值 是 相对 的 。 同 时 ， 无 论 多 少 Games 连 接 到 这 个 Passer 都 
没有 关系 。 


8) Delete Rule 非 常 重要 。 如 果 将 Passer 从 数据 库 中 移 除 ， 会 出 现 什 么 问题 ? 你 可 能 不 想 保 留 它 对 应 的 Game 数 据 。 保 留 一 
些 没 有 连接 到 任何 Passers 的 统计 信息 是 没有 意义 的 。 这 里 有 4 个 选择 。 
. No Action (不 操作 ) : 当 Passet 被 删除 的 时 候 ， 不 做 任何 操作 。Passet 对 应 的 Game 将 会 变 为 孤立 的 对 象 ， 它 们 对 刚 删 除 的 
Passet 的 引用 称 为 悬浮 引用 。 你 不 想 出 现 这 样 的 结果 。 


- Nullify (使 无 效 ) : 差强人意 ; Game 仍 然 存 在 于 数据 库 中 ， 但 是 至 少 停 止 了 Passet 的 向 后 引用 。 


-Deny (4226) : 这 个 操作 有 点 过 ， 若 执行 了 这 个 操作 ， 那 和 勾当 Passer 关 联 Game 的 时 候 ， 就 不 允许 删除 Passer。 必 须要 在 删 


除 Passet 之 前 ， 删 除 与 之 相关 的 所 有 Game。 


` 最 合适 的 操作 是 Cascade (AR) 。 当 删除 一 个 Passer 的 时 候 ， 按 图 索取 删除 所 有 与 之 有 关系 的 对 象 ， 要 达到 的 目标 就 是 : 


没有 Passet， 就 没有 对 应 的 Game。 
9) inspector 剩 下 的 部 分 包括 全 局 搜索 、 元 数据 以 及 刚才 展示 的 版 本 控制 属性 。 这 些 你 都 不 用 天 心 。 


现在 ， 你 能 查询 一 个 Passer 对 应 的 全 部 Game 数 据 ， 它 会 返回 对 应 的 数据 。 但 是 无 法 查 到 一 个 Game 对 象 对 应 的 Passer。 这 
需要 建立 一 个 反 向 天 系 (inverse relationship) 。 选 择 Game 实 体 ， 创 建 一 个 名 为 passer 的 关系 。 天 系 的 一 新 是 Passer， 另 一 映 


是 game。 


w+ 事实 上 ， 关 系 一 般 都 是 双向 的 ， 如 果 仅 仅 指 定 了 关系 的 一 方 ， 将 .xcdatamodel 转 化 为 .mom 的 编译 器 momc 就 会 发 出 


Be 
vw Vo 


既然 你 已 经 拥有 了 一 个 一 对 多 关系 ， 你 束 可 以 指定 一 个 有 反 向 关系 : 在 Inverse 列 中 ， 指 定 games。 在 Data Model inspector 
中 ， 这 个 天 系 是 必 选 的 : 因为 没有 Passer 的 Game 将 写 无 意义 ， 我 们 希望 Core Data 能 够 强制 做 到 这 点 。 将 Type 设 置 为 To 
One， 这 样 Core Data 就 知道 将 Passer 视 为 直接 连 到 一 个 而 不 是 多 个 Passer。 对 于 这 个 关系 ，Delete Rules 应 该 设置 为 Nullify 
一 一 当 移 除 Game 的 时 候 ，Passer 也 应 该 还 会 存在 。 


现在 完成 了 数据 模型 。 单 击 底部 Editor Style 控件 (右手 边 ) 图 形 风格 的 按钮 能 查看 到 所 有 的 实体 如 图 9.2 排 列 ， 这 看 起 来 与 
图 8.1 中 的 原始 设计 很 类 似 〈 如 果 两 个 实体 友 生 了 重 晋 ， 你 可 以 将 它们 拖 开 ) 。 


四 Passer Rating > Passer Rating [E Passer_R...tamodeld ) | 电 Passer_Rating.xcdatamodel ; No Selection 
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图 9.2 Data Model 编 辑 器 的 图 形 风 格 会 以 框图 (block diagram) 的 形式 显示 出 模型 中 的 所 有 实体 。Passet 与 Game 之 间 一 对 多 关系 的 
体现 方式 是 : 有 一 个 箭头 指向 Passerf， 有 很 多 箭头 指向 Game 端 


如 果 愿 意 ， 你 可 以 在 Graph 视图 中 编辑 甚至 创建 数据 模型 。 这 仪 需要 使 用 Add 按 钮 和 Data Model inspector, 


Os 这 个 数据 模型 并 不 会 将 数据 集合 作为 “真正 的 ”数据 库 设 计 。Game 这 个 词 有 些 用 词 不 当 ， 因 为 它 上 暗含 在 特定 时 间 
和 地 点 发 生 的 特定 比赛 ， 且 必须 至 少 有 两 个 四 分 卫 。 但 在 这 里 ， 用 Game 表 示 一 个 传 球 手 在 某 个 比赛 中 的 表现 。 更 精确 的 模型 应 
该 用 Game 实 体 来 描述 这 场 比 赛 ， 然 后 用 连接 来 链接 Passet 与 Game， 并 保存 一 个 四 分 卫 在 这 场 比赛 中 的 表现 。 更 进一步 ， 一 个 四 
分 卫 在 他 的 职业 生涯 中 可 能 会 为 多 个 球 队 效力 ， 列 出 他 在 某 个 球 队 中 打 的 所 有 比赛 应 该 很 有 意思 。 这 个 数据 模型 应 该 从 Passef 和 


Game 规 范 化 一 个 新 的 Team 实 体 。 注 意 ， 这 只 是 举例 而 已 。 


9.2 BWR 


马上 就 要 开始 使 用 这 个 数据 模型 了 。 用 Core Data 实 例 化 一 个 Game 对 象 作 为 NSManaged Object 类 的 通用 对 象 ， 当 你 传 入 
一 个 名 字 aGame.setValue (aDate:forKey"whenPlayed" 时 ， 那 么 这 个 对 象 能 够 设置 、 存 储 并 返回 它 的 属性 。 按 照 同样 的 方 
法 ， 实 例 化 一 个 Passer 类 ， 它 应 该 是 一 个 NSManagedObject 类 ， 它 能 够 处 理 所 有 的 属性 。 它 应 该 能 够 正常 工作 。 如 果 没 有 修 
改 项 目 模板 ， 这 个 类 应 该 服务 于 Event 实 体 。 


你 会 上 友 现 有 很 多 和 忒 西 都 不 在 数据 模型 中 ， 比 如 没有 passer-rating 相 天 的 属性 一 一 整个 应 用 程序 的 关注 点 。Passer 没 有 天 于 
career attempts、completions、yards 的 属性 ， 这 要 如 何 处 理 ? 


你 要 做 的 就 是 当 应 用 程序 运行 的 时 候 ， 计 算 传 球 手 的 rating 还 有 其 他 状态 值 ， 而 不 是 存储 这 些 内 容 。 这 些 统计 数据 都 来 自 于 
存储 的 数据 。 为 了 做 这 些 运算 ， 需 要 Swift 方法 来 获取 Passer 和 Game 的 属性 。 想 要 使 用 这 些 方法 ， 你 需要 实现 这 些 方法 的 类 
(恰巧 是 NSManagedObject 的 子 类 ) 。 需 要 为 这 两 个 类 提供 .swift 文 件 。 


» 汪 意 ”如 果 到 现在 为 止 ， 你 一 直 都 按照 书 中 的 介绍 操作 ， 那 么 为 安全 起 见 ， 现 在 请 提交 项 目 。 可 以 参照 7.3 节 。 


9.2.1 创建 类 一 一 错误 的 万 法 


下 面 是 Xcode 提供 的 创建 子 类 NSManagedObject 的 方法 ， 不 过 这 种 方法 不 正确 。 如 果 你 还 是 想 要 坚持 用 这 种 方法 创建 类 ， 
请 确保 已 经 按照 我 刚才 所 说 的 将 已 有 代码 提交 ， 然 后 创建 一 个 名 为 native-mo-classes 的 新 分 文 (Source Control 一 Working 
Copy 一 New Branch) 做 这 次 试验 。 当 完成 这 个 尝试 之 后 ， 再 回 到 主 分 文 ， 从 上 次 结束 的 位 置 继续 执行 。 


HF ile—Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/... (ÆN) 。 在 New File 界 面 中 找到 iOS 一 Core 
Data—NSManagedObject subclass。 它 的 描述 是 An NSManagedObject subclass， 但 是 这 个 摘 述 低估 了 这 个 类 的 作用 。 单 
击 Next 按 钮 。 


wit Data Model 编 辑 器 可 见 时 ， 只 要 至 少 选 中 了 一 个 实体 ， 而 通过 选择 Editot 一 Cteate NSManagedObject Subclass， 也 
能 在 不 使 用 模板 选择 器 的 情况 下 到 达 同 样 的 位 置 。 


接 下 来 的 两 页 专门 用 来 介绍 创建 NSManagedObeject。 首 先 会 展示 项 目 中 的 数据 模型 列表 (本 例 中 只 有 一 个 ) 。 勾 选 想 要 
生成 类 的 数据 模型 旁边 的 方 框 。 下 一 页 列 出 了 在 这 些 模型 中 定义 的 所 有 实体 ， 选 择 想 要 生成 类 的 实体 。 因 为 要 为 Passer 和 和 Game 
创建 自 定义 类 ， 所 以 选取 这 两 个 实体 ， 然 后 单 击 Next 按 钮 。 


现在 会 出 现 一 个 让 你 选择 存放 源 文件 的 目录 界面 。 为 了 整洁 起 见 ， 单 独 为 模型 对 象 创建 一 个 文件 夹 : 选中 Passer_Rating 目 
录 ， 单 击 New Folder， 然 后 将 其 命名 为 Model。 请 确保 新 文件 夹 在 文件 浏览 器 中 处 于 被 选中 的 状态 。 


除了 Project-navigator 组 (将 其 放 入 Passer Rating target 对 应 的 组 中 ) 和 targets (app 对 应 的 target 而 不 是 tests 对 应 的 
target) 选择 器 外 ，get-folder 界 面 还 有 一 个 Language 弹 出 框 (选择 Swift) ， 以 及 一 个 写 着 Use scalar properties for 
primitive data types 的 复 选 杠 。NSManagedObject 是 用 于 存放 对 象 值 的 容器 ， 比 如 类 似 于 completions 这 样 的 数字 必须 要 包 
合 在 NSNumber 对 象 中 。 


对 于 Core Data 的 工作 方式 来 讽 ， 这 很 正确 ， 所 以 在 这 个 练习 中 取消 勾 选 它 。 但 是 数字 的 妆 箱 (boxing) 和 拆 箱 
(unboxing) 会 让 你 的 工作 量 更 大 。 如 果 勾 选 这 个 选项 ， 新 的 子 类 融会 将 数字 的 原始 形式 暴露 企 外 ， 它 会 帮助 你 完成 妆 箱 拆 箱 
的 工作 。 


单 击 Create 按 钮 ， 在 Passer 和 Game 代 码 对 应 的 Project 导 航 器 中 可 以 看 到 两 个 新 文件 ， 它 们 上 面 都 有 一 个 A 标签 ， 表 示 它 们 
已 经 添加 到 了 本 地 代码 仓库 中 ， 但 是 还 没有 提交 。 为 了 保持 Project 导 航 器 的 整洁 ， 选 中 这 些 新 文件 (必要 的 时 候 按 住 shift 键 或 
者 command 键 ) ， 然 后 选择 File 一 New 一 Group from Selection， 这 些 文 件 就 会 被 放 到 一 个 名 为 New Group 的 新 组 中 ， 单 击 
这 个 组 名 并 按 return 键 残 能 重新 命名 (比如 ， 改 为 DataModel) 。 


现在 项 目 和 数据 模型 文件 都 被 标记 为 M 标 签 ， 反 映 出 这 些 文件 有 更 改 ， 以 及 为 Passer 和 Game 实 体 创建 了 对 应 的 类 。 


9 注意 ”Project 导 航 器 用 黄色 的 文件 夹 代表 分 组 ， 你 可 能 会 将 文件 夹 图 标 与 系统 文件 夹 联 系 起 来 ， 但 实际 上 并 不 是 这 样 。 
首先 ，Xcode 中 黄色 的 分 组 文件 夹 仅 仅 是 组 织 文件 的 一 种 简单 方式 。 存 储 在 相同 文件 夹 中 的 文件 可 能 属于 不 同 的 分 组 ， 将 一 个 文 
件 从 一 个 分 组 中 移动 到 田 外 一 个 分 组 并 不 会 改 交 它 在 硬盘 中 的 位 置 。 


刚才 你 是 在 一 个 单独 的 分 支 上 做 实验 ， 现 在 是 时 候 回 到 主 分 支 继续 工作 了 。 如 果 没 有 提交 更 改 ，Xcode (和 Git) 会 发 出 对 
应 的 提示 信息 。 提 交 完 成 后 ， 在 项 目的 Source Control| 子 菜单 中 选择 Switch to Branch, 


Ose 如 果 你 之 前 没有 创建 一 个 分 支 ， 那 么 选择 Source Control—Discard All Changes， 将 版 本 回 退 到 之 前 没有 生成 类 文件 


的 版 本 。 


9.2.2 ”为 什么 按照 Xcode 的 方式 做 是 个 错误 


现在 ， 做 个 假设 : 之 所 以 创建 Passer 和 Game 类 ， 是 因为 你 想 要 获得 更 多 的 方法 ， 而 不 仪 仪 是 Core Data 提 供 的 功能 。 你 可 
能 想 要 这 样 添加 方法 : 


/// Fetch an array of all games played on a certain date. 
/// :bug: As implemented, the games must have been played 
/// at the same instant. 
class func gamesOnDate(date: NsDate, 
inContext context: NSManagedObjectContext) 
-> [Event] ? 


// Ask for all Games... 
let req = NSFetchRequest (entityName: "Game") 
// ... played on a certain date 
req.predicate = NSPredicate(format: "whenPlayed = %@", date) 
// Do the fetch: 
var error: NSError? 
let result: [AnyObject]? = context.executeFetchRequest (req, 
error: &error) 
if result == nil { 
// I£ it were no-matches, result would be []. 
// A nil means there was an error; log it. 
NSLog("gamesOnDate fetch failed; error = %@", 
error!) 
} 


return result as? [Event] 


还 不 错 ， 接 下 来 ， 向 Game 实 体 中 添加 一 个 字符 串 属性 weather， 现 在 又 如 何 呢 ? 





如 果 你 之 后 想 让 Game 与 数据 模型 的 更 改 保 持 一 致 一 一 因 为 过 段 时 间 数 据 模型 可 能 会 比 现在 更 复杂 尔 可 能 想 要 重复 从 
数据 模型 中 生成 这 些 代码 的 过 程 。 当 你 尝试 这 么 做 的 时 候 ，Xcode 什 么 都 不 会 做 。 更改 仍 然 只 作用 于 数据 模型 中 ， 但 是 
Game.swift 不 会 友 生 任何 改变 。 





你 陷入 了 困境 。 现 在 还 不 是 很 糟粕 一 一 只 是 假如 了 另外 一 个 QNSManaged 变 量 声明 一 一 但 是 随 背 数据 模型 越 来 越 复杂 ， 


是 
这 种 更 改 方式 束 会 变 得 十 分 容易 出 错 。 
9.2.3 ”正确 的 万 法 一 一 使 用 mogenerator 


Xcode 处 理 Core Data 的 方式 并 不 是 首次 因为 代码 目 动 化 生成 而 出 现 的 问题 。 在 面向 对 象 编程 中 ， 解 决 方案 几乎 都 是 让 生成 
器 获得 它 所 创建 类 的 唯一 控制 权 ， 然 后 用 尸 从 这 个 类 派生 目 定义 类 。 但 是 ，Xcode 托 管 对 象 类 生成 器 对 你 来 说 缺乏 足够 的 灵活 
性 ， 你 不 得 不 手动 修改 子 类 。 


Jone “Wolf”Rentzsch 编 写 了 一 个 名 为 mogenerator 的 命令 行 工 具 ， 专 门 用 来 完成 这 个 任务 。 从 这 里 下 载 并 安装 这 个 工 
H: http://rentzsch.github.io/mogenerator/。 安 装 器 会 将 mogenerator 放 到 /usr/bin 中 ， 这 样 命令 行 就 能 使 用 这 个 工具 。 


全 注意 像 mogeneratotr 这 样 的 工具 不 得 不 适 配 Swift 的 开发 ， 当 它们 开始 做 适 配 工作 后 ， 就 会 频繁 地 发 生 更 改 。 为 了 保持 总 
是 使 用 最 新 版 本 ， 你 最 好 从 GitHub 上 获取 最 新 版 本 : https://github.com/rentzsch/mogenerator. 


这 次 ， 你 将 会 使 用 刚刚 恢复 的 “ 正 弟 ”项 目 副本 。Xcode 的 生成 器 会 自动 填充 类 的 名 称 ， 但 是 mogenerator 会 让 你 自行 设 
置 。 在 Utility area 中 打开 Data Model inspector， 选 中 Game， 然 后 将 Class 设 置 为 Game; 然后 选中 Passer， 将 Class 设 置 为 


Passer。 
monogenerator 是 一 个 命令 行 工 具 ， 它 有 很 多 选项 。 每 次 你 仪 需 使 用 带 有 相同 参数 的 命令 。 


下 面 是 一 个 从 终端 执行 的 脚本 命令 : 
#! /bin/bash 
echo $(which mogenerator) 


# Conjure a name for the generated files 
OUT_DIR=""dirname "$1" /mogenerated" 


mogenerator --model "$1.xcdatamodeld" \ 
--swift \ 
--output-dir "$0UT DIR" 


ls "$OUT_DIR" 


Ose 生成 Swift 托管 对 象 类 的 选项 非常 简明 ; 需要 注意 Objective-C 的 输出 内 容 。 运 行 mogehetatof - help 可 以 查看 可 用 的 选 


可 以 在 示例 代码 中 找到 这 个 脚本 ， 名 为 run mongenerator.sh。 将 它 复 制 到 项 目 目录 ， 或 者 上 一 层 上 目录， 这样 输入 路 径 就 
“会 很 长 ， 打 开 Terminal 应 用 ， 然 后 运行 以 下 代码 : 


$ # Make the script containing the script current. 
$ cd parent-directory 

$ # In this example, this directory contains the project directory 
$ ls Passer\ Rating 

AppDelegate.swift Info.plist 

Base. lproj MasterViewController.swift 
DetailViewController.swift Passer_Rating.xcdatamodeld 
Images.xcassets 

$ # Make sure the script is executable 

$ chmod +x run_mogenerator.sh 

$ ./run_mogenerator.sh Passer\ Rating/Passer_Rating 
/usr/local/bin/mogenerator 

2 machine files and 2 human files generated. 
Game.swift Passer.swift _Game.swift _Passer.swift 


$ 


执行 这 段 代 码 之 后 ， 项 目 目录 将 会 包含 一 个 名 为 mogenerated 的 新 目录 ， 它 包含 Game 和 Passer 类 对 应 的 .swift 文 件 ， 以 及 
用 于 连接 到 实体 的 Game.swift 和 _Passer.swift 文 件 。 当 你 对 数据 模型 做 出 更 改 的 时 候 ， 再 次 运行 mogenerator， 它 会 重新 生成 
带 下 划 线 的 文件 (当然 你 不 用 更 改 ) 以 反映 出 对 应 的 更 改 ， 而 不 会 对 你 的 文件 做 任何 改动 。 


全 注意 mogenerator、Swift 和 Swift 关 于 Core Data 的 接口 可 能 要 花 一 段 时 间 才 能 稳定 。 你 不 应 该 编辑 机 器 生成 的 〈 带 下 划 线 


的 ) 文件 ， 但 是 有 的 时 候 ， 你 可 能 不 得 不 修复 编译 器 警告 其 至 前 溃 。 见 第 17 章 ， 在 那里 我 们 不 得 不 修改 mogenetatof 生 成 的 默认 代 


码 ， 让 它 能 够 在 库 中 使 用 。 


在 开始 使 用 新 文件 之 前 ， 它 们 应 该 是 项 目的 一 部 分 。 将 它们 添加 a 到 项 目 中 的 一 种 方法 是 打开 Finder 窗 口 ， 显 示 它 们 的 图 标 ， 
然后 将 它们 (依次 、 一 起 或 者 在 包含 它们 的 文件 夹 中 ) 拖 入 Project 导 航 器 中 。 确 保 清除 导航 器 底部 的 过 滤器 只 有 你 知道 要 将 文 
件 放 到 项 目 中 的 哪个 位 置 的 时 候 它 才能 接受 新 文件 。 


另外 一 种 方法 是 选择 File 一 Add Files to “Passer Rating” (CHA) ， 就 会 看 到 一 个 选择 文件 (如 果 它 们 在 同样 的 目录 
中 ， 按 command 键 瓯 能 选中 它们 ) 或 者 文件 夹 的 界面 。 


确定 文件 后 还 不 够 ， Xcode 还 需要 更 多 信息 ， 这 些 信息 可 能 会 出 现在 拖 忠 时 的 弹出 界面 中 ， 或 者 在 选择 文件 的 高 级 扩展 中 。 
这 些 选 项 如 下 。 


- Destination: Copy items if needed。 在 这 种 情况 下 ， 新 文件 会 处 于 项 目 文件 所 在 的 根 目 录 中 。 但 并 不 总 是 这 样 ， 可 能 你 会 从 
其 他 项 目 中 导入 资源 或 者 文件 。 你 可 能 想 让 Passef Rating 简 单 地 指向 共享 文件 ， 但 是 更 常见 的 情况 是 你 想 要 项 目 目录 是 一 个 自 包 


含 的 包 。 在 这 种 情况 下 ， 勾 选 这 个 选项 ，Xcode 就 会 将 文件 复制 到 项 目 目录 中 。 


- Add folders。 如 果 向 项 目 中 添加 一 个 目录 ， 你 可 能 会 选择 两 种 方法 中 的 一 种 : 在 本 例 中 ， 添 加 mogenetated 目 录 ， 就 能 添加 
它 所 包含 的 所 有 文件 。 选 择 Create Groups 就 能 在 Project 导 航 器 中 创建 一 个 黄色 的 组 文件 来 ， 它 包含 这 个 目录 中 的 全 部 文件 。 但 是 


想象 下 包含 美国 所 有 总 统 画 像 的 一 款 应 用 程序 ， 你 可 能 想 在 下 一 年 自由 更 改 或 添加 总 统 的 画像 。 文 件 夹 本 身 需 要 复制 到 最 终 的 应 


用 程序 中 。 如 果 你 恰好 想 这 么 做 ， 那 么 选择 Create folder references。 文 件 夹 引用 将 会 以 蓝 色 的 图 标 显 示 在 Project 导 航 器 中 。 
- Add to targets。 它 是 一 个 表 ， 其 中 会 显示 项 目 中 每 个 target。 在 这 个 例子 中 ， 仅 包含 Passer Rating 和 Passer RatingTests。 在 第 6 


章 中 ， 你 已 经 熟悉 了 target 和 关系 。 这 个 表 是 一 次 性 管理 所 有 新 文件 的 便捷 方法 。 如 果 新 文件 中 包含 C 家 族 的 文件 ， 不 用 管 头 文 
件 ，Xcode 会 自动 将 它们 排除 在 外 (在 target 中 添加 一 个 以 .h 结 尾 的 文件 ， 会 将 它 作 为 资源 文件 添加 到 最 终 的 应 用 程序 中 ， 你 基本 
不 需要 这 样 做 ) o 


在 这 个 例子 中 ， 请 选择 Added folders， 将 它 设置 为 Create groups for any added folders; 然后 选中 Passer Rating 作 为 
唯一 的 target。 这 些 文件 已 经 处 于 项 目 目录 树 中 了 ， 所 以 丈 不 用 再 次 复制 它们 。 


如 果 你 及 用 拖 岛 文件 的 方法 ， 那 么 单 击 Finish 按 钮 ;如 果 使 用 添加 文件 界面 ， 那 么 单 击 Add 按 钮 。 


93 准备 
本 书 之 前 的 版 本 没有 紧密 结合 Xcode 根据 项 目 模 板 生成 的 代码 ， 我 的 想法 是 你 应 该 仪 关 心 那 些 对 工作 流 比 较 重 要 的 部 分 。 但 
是 这 一 次 不 一 样 。 


Passer Rating 有 许多 上 自己 的 需求 ， 很 多 应 用 程序 都 有 目 己 的 需求 。 模 板 代 码 包 含 的 有 用 内 容 太 少 ， 而 见 余 内 容 太 多 ， 这 是 
因为 模板 的 目的 束 是 提供 大 量 措 引 性 的 功能 。 在 某 些 情况 下 ， 使 用 模板 能 生成 一 个 普通 的 应 用 程序 结构 ， 但 是 很 难 作为 一 个 优秀 
的 应 用 程序 。 


这 一 次 ,我 将 修改 模板 代码 ， 让 过 程 更 清晰 。 首 要 目标 束 是 工具 和 扩展 形式 的 基础 设施 。 我 会 在 需要 的 时 候 完 善 这 些 内 容 ， 
现在 我 们 乞 从 这 里 开始 。 这 里 介绍 的 会 比较 简单 ， 但 是 你 可 以 从 示例 代码 的 注释 中 学 习 到 更 多 和 内容 。 


9.3.1 Utilities 


Utilities.swift 文 件 中 将 会 添加 一 些 常见 的 便捷 方法 ， 比 如 字符 串 格式 化 、 文 件 处 理 ， 还 有 本 草 将 会 用 到 且 在 第 5 章 中 已 经 
到 的 用 于 固定 布局 的 肖 数 。 
/大 炎炎 炎炎 炎炎 火光 炎炎 炎炎 Pinning functions ****xKeekeee eee / 


/// Pin a “Comparable between two limit ‘Comparable s of the 
/// same type. 


func pinComparables<T:Comparable> ( 
value: T, lower: T, upper: T) -> T 


if value < lower { return lower } 
else if value > upper { return upper } 
else { return value } 


/// Given a lower and upper bounds, return a function that 
/// will pin a ‘Comparable between them. 


func limitPinner<T: Comparable> 
(iower: T; upper: T) -> (T «> T) 
{ return { value in pinComparables(value, lower, upper) } } 


9.3.2 扩展 类 


Extensions.sSwift 将 会 在 仔 在 的 类 中 添加 函数 和 属性 。 


首先 是 NSFetchedResultsController， 应 用 程序 用 它 来 管理 获取 的 Core Data 对 象 。 给 定 一 个 实体 ， 选 择 条 件 、 排 序 方式 
和 分 组 数据 的 方式 ，NSFetchedResultsController 会 处 理 载 入 数据 的 细节 ， 并 显示 在 应 用 程序 中 。 


iOS 应 用 程序 通常 会 使 用 获取 结果 的 控制 器 填充 UITableViews 的 节 和 行 。 可 以 通过 将 节 和 行 转化 成 两 层 的 索引 路 径 ， 然 后 通 
过 objectAtlndexPath 将 它 传递 给 结果 控制 器 来 选择 对 和 象 。 


这 听 起 来 像 一 个 子 脚本 : 你 不 应 该 将 两 个 数字 转化 成 一 个 路 径 ， 然 后 将 它 放 入 到 必 长 的 尔 数 调用 中 。 季 运 的 是 ，Swift 能 让 
你 定义 子 脚本 : 


[kkkkkkkkkkkkkkkkkkk* NSFetchedResultsController kkkkkkkkkkkkkkkkkk*/ 


/xx Add subscripts to NSFetchedResultsController. «/ 
extension NSFetchedResultsController { 


/** Return a managed object given an index path. */ 
subscript (indexPath: NSIndexPath) -> NSManagedObject { 
return self.objectAtIndexPath (indexPath) as! NSManagedObject 


/** Return a managed object given section and row numbers. */ 
subscript (section: Int, row: Int) -> NSManagedObject { 
let indexPath = NSIndexPath(forRow: row, inSection: section) 
return self [indexPath] 


UITableView 也 能 通过 cellIForRowAtlndexPath 芳 数 ， 借 助 路 径 或 者 节 和 行 (section-and-row) 检索 对 象 。 将 它 转 换 成 表 
视图 的 实例 函数 。 


[kkk KKK KKK KKK KKK ULTAblLeView *x*žkkžkkkžkkkkkkkkk*kkx/ 


/xx Add subscripts to retrieve a table-view cell by path or section+row. 
*/ 


extension UITableView { 
/xx Return a table-view cell given an index path. 


:bug: Should check the arity (2) of the path. 
:bug: Does not handle the exception raised for indices 
out of range. 
x / 
subscript (indexPath: NSIndexPath) -> UITableViewCell { 
return self.cellForRowAtIndexPath (indexPath) 


/x* Return a table-view cell given section and row. 
Implemented through self.cellForRowAtIndexPath. 


:bug: Could bounds-check the section and row, but does 
not. 
*/ 
subscript (section: Int, row: Int) -> UITableViewCell { 
let indexPath = NSIndexPath(forRow: row, inSection: section) 
return self.cellForRowAtIndexPath (indexPath) 


9.3.3 passer rating 


我 们 在 第 3 章 中 写 了 一 个 计算 passer ratings 的 C 国 数 。 这 次 使 用 Utilities.swift 中 的 一 般 限 制 器 函数 重 写 这 个 方法 。 


/// Define a function that pins a Double to the range for 
/// a component of an NFL/CFL passer rating. 
let ratingPinner = limitPinner(0.0, 2.375) 


/// Calculate the NFL/CFL passer rating, given performance 

/// statistics for a game (or any other time period). 

func passer_rating(#completions: Int, #attempts: Int, 
#yards: Int, #touchdowns: Int, 
#interceptions: Int) 
-> Double 


// See http://en.wikipedia.org/wiki/Quarterback_Rating 
if (attempts <= 0) { return 0.0 } 


// Statistic-per-attempt, with both converted to Double, 
// recurs in all four components. Make the definitions 
// easier to read and understand by encapsulating it. 
func perAttempt(stat:Int) -> Double { 

return Double(stat) / Double(attempts) 


// Compute the components to sum into the rating 
let components = [ 


(100.0 * perAttempt ( completions) - 30.0) / 20.0, 
(perAttempt ( yards) - 3.0) / 4.0, 

20.0 * perAttempt ( touchdowns), 

2.375 - (25.0 * perAttempt( interceptions) ) 


] 


// Pin the components and add them up 
let retval = components.map(ratingPinner) .reduce(0.0, +) 
return 100.0 * retval / 6.0 


Swift 编写 函数 的 方式 与 C 编 写 国 数 的 方式 有 很 大 不 同 。 
过 特殊 化 一 般 的 限制 器 创建 了 限制 函数 (ratingPinner) 。 
Passer_rating 定 义 了 一 个 内 部 负数 (perAttempt) ， 用 于 简化 < 语言 那 种 混乱 模糊 的 代码 版 本 。 


之 前 每 个 值 都 存放 在 局 部 变量 中 ， 现 在 将 这 些 值 都 放 在 数组 中 。 之 前 那些 值 分 别 存放 在 局 部 变量 中 ， 并 不 是 因为 我 们 要 区 分 
每 个 值 ， 而 是 因为 我 们 没有 更 好 的 办 法 保存 这 些 值 用 于 之 后 的 处 理 。 


限制 器 将 会 应 用 到 所 有 的 组 件 值 上 ， 你 可 以 使 用 compoents.map (ratingPinner) 将 一 个 函数 映射 到 数组 上 ， 这 样 束 会 应 
用 ratingPinner 这 个 国 数 到 每 个 条 目 上 ， 然 后 返回 市 有 对 应 结果 的 数组 。 


我 们 之 后 会 计算 经 过 调整 的 值 的 和 ， 它 们 最 终 会 变 为 同一 个 值 ， 所 以 我 们 不 需要 区 分 每 个 值 ， 但 是 Ci 语言 却 要 求 我 们 区 分 每 
个 值 。Array 的 reduce 方 法 接受 一 个 开始 位 置 ， 然 后 将 一 个 国 数 应 用 到 选 定 的 值 。 Plus 是 一 个 国 数 ， 如 果 你 想 计 算 grand total 这 
个 值 ， 那 瓯 从 0 开始 。anArray.reduce (0.0, +) 将 会 返回 一 个 Double 总 计 什 。 


使 用 像 动态 定义 的 浮 数 和 数组 这 些 概 念 能 让 我 们 从 顶层 考虑 问题 ， 而 不 用 管理 底层 数字 值 的 生命 周期 。 而 且 不 算 注 释 的 
话 ，Swift 重 写 后 的 代码 行 数 只 有 C 语 言 版 本 的 3/4。 


94 定制 Core Data 类 


我 们 已 经 做 了 一 些 准 备 工作 ， 现 在 可 以 开始 将 Game 和 Passer 类 与 数据 库 中 的 数据 关联 在 一 起 。mogenerator 提 供 的 市 下 
划 线 的 类 用 于 转 储 数 据 库 中 的 记录 ， 而 普通 的 类 会 在 Passer Rating 中 使 用 这 些 数 据 。 


94.1 在 项 目 中 添加 Game 数 据 


mogenerator 在 生成 的 类 中 添加 了 很 多 便捷 的 属性 和 方法 。 比 如 说 ， 在 _ Game 中 ， 你 会 上 友 现 如 下 代码 : 


@NSManaged var attempts: Int32 
@NSManaged var ourTeam: String 


@NSManaged 中 的 Swift 并 不 是 将 这 些 属性 视 为 代码 或 者 用 于 访问 内 存 数据 ， 而 是 访问 Core Data 中 存储 的 值 的 端口 。 


Game.swift 属 于 我 们 目 己 拥有 。 让 我 们 为 存储 的 数据 添加 第 一 个 扩展 ， 这 个 应 用 程序 如 下 : 


@obj c (Game) 

class Game: _Game { 
var passerRating: Double { 
return passer_rating ( 


completions: Int (self.completions), 
attempts: Int (self.attempts), 
yards: Int (self.yards), 
touchdowns: Int (self.touchdowns), 
interceptions: Int(self.interceptions) 


) 


我 们 在 passer_rating 国 数 的 参数 上 添加 了 #， 所 以 我 们 不 得 不 在 调用 的 时 候 包 含 参数 标签 。 这 不 是 件 坏事 ， 因 为 没有 内 在 的 
原因 保证 这 些 参 数 能 按 顺 序 传 入 ， 标 签 能 防止 值 放 到 错误 的 位 置 。 


passerRating 是 Game 的 双 值 (Double-valued) 属性 。 它 会 被 计算 (但 是 不 存储 ) ， 因 为 只 有 一 部 分 代码 与 之 关联 ， 只 
读 取 ， 不 能 设置 。 
9.4.2 ”在 项 目 中 添加 Passer 数 据 


PasserhvizApasser rating 的 相关 信息 ， 但 是 Passer 并 不 包含 计算 它们 的 数据 ， 这 些 数据 全 部 来 自 于 与 之 相关 的 比赛 。 所 
以 我 们 必须 要 添加 一 些 代 码 暴 露出 这 些 数据 ， 然 后 根据 这 些 数 据 计 算出 职业 生涯 评分 
/// The passer’s career passer rating 


var passerRating: Double { 
return passer_rating ( 


completions: self.completions, 
attempts: self.attempts, 
yards: self.yards, 
touchdowns: self.touchdowns, 
interceptions: self.interceptions) 


/**x Helper function to get the sum of a career statistic 
@param attribute the name of a key for an integer attribute of Game 


*/ 
func sumOfGameAttribute (attribute: String) -> Int 
{ 


let keyPath = "@sum.\ (attribute) " 

return self.games.valueForKeyPath(keyPath) as Int! 
var attempts:Int { return sumOfGameAttribute ("attempts") } 
var completions:Int { return sumOfGameAttribute ("completions") } 
var yards:Int { return sumOfGameAttribute("yards") } 


var touchdowns:Int { return sumOfGameAttribute ("touchdowns") } 


var interceptions:Int { return sumOfGameAttribute("interceptions") } 


我 们 充分 利用 了 键 值 的 编码 方法 valueForKeyPath: 从 games 集 合 中 的 每 场 比赛 中 提取 (比如 说 ) attempts 的 数据 ， 然 后 
计算 和 (@sum) 。 


你 也 可 以 得 到 某 些 有 趣 的 值 ， 比 如 |: 


var firstPlayed: NSDate { 
return self.games.valueForKeyPath ("@min.whenPlayed") as! NSDate 


var lastPlayed: NSDate { 
return self.games.valueForKeyPath ("@max.whenPlayed") as! NSDate 


var teams: [ String ] 


let theGames: AnyObject = 
self.games.valueForKeyPath ( 
"@distinctUnionOfObjects.ourTeam") 
return theGames.allObjects as [ String ] 


9.4.3 ”一 绎 测试 数据 


如 果 没 有 数据 支持 ， 那 Passer Rating 也 将 无 法 工作 。 在 一 款 完 成 的 产品 中 ， 获 得 数据 会 比较 简单 : 用 户 提供 了 他 自己 的 数 
据 。 但 是 我 们 不 想 等 到 完成 App 大 部 分 功能 的 时 候 才 看 到 它 的 工作 方式 。 你 需要 把 一 些 测试 数据 预 加 载 到 App 中 。 


测试 数据 可 以 采用 CSV 格 式 的 文件 。 我 有 一 个 脚本 generate-games.rb， 它 会 生成 质量 上 乘 的 数据 集 


firstName,1lastName,attempts,completions,interceptions, 

Jimmy, Carter,37,11,1,0,56,2010-03-24,Boise Bearcats,2, 

Andy, Jackson, 33,8,1,1,30,2010-03-24,Modesto Misanthropes,9, 

James ,Madison,20,15,0,4,241,2010-04-14,San Bernardino Stalkers,47, 
Quinn, Adams,9,3,1,1,17,2010-04-14,San Bernardino Stalkers,47, 





SER 这 段 脚本 大 概 有 280 行 ， 代 码 很 简单 。 它 的 输出 有 些 缺 陷 ， 记 录 中 团队 A 与 团队 B 的 比赛 和 团队 B 与 团队 C 的 比赛 在 
同一 天 ，Big Bill Taft 的 表现 出 于 你 的 意料 。 这 些 问 题 与 App 无 关 ， 想 要 获得 更 多 信息 ， 请 查看 维基 百科 上 面 的 词 条 YAGNI。 


如 果 样 本 数据 不 存在， 或 者 生成 的 数据 与 最 新 的 generate-games.rb 原 本 应 该 生成 的 数据 不 符 ， 那 么 应 该 重新 生成 。Xcode 
能 帮 有 我 们 处 理 好 这 件 事 吗 ? 


是 的 ， 首 先 ， 用 你 之 前 使 用 过 的 方法 将 generate-games.rb 添 加 到 项 目 中 ， 或 者 简单 地 将 它 从 Finder 中 拖 到 项 目 里 。 不 要 


一 一 


将 它 添加 到 任何 target 中 ， 它 仅仅 是 一 个 工具 ， 并 不 是 构建 应 用 程序 时 所 需 的 一 部 分 


现在 打开 Project 编 辑 器 (〈 单 击 Project 导 航 器 最 上 的 一 行 ) ， 选 择 target: Passer Rating。 单 击 Build Phases 选 项 卡 ， 找 到 
Passer Rating 的 构建 步骤 。 我 们 想 要 这 个 构建 过 程 中 添加 运行 这 个 脚本 的 步 又。 选择 Editor 一 Add Build Phase 一 Add Run 
Script Build Phase， 命 名 为 一 个 新 步骤 Run Script， 显 示人 在 最 下 面 。 但 是 在 Copy Bundle Resources 这 一 步 将 数据 复制 到 应 用 
程序 之 后 再 运行 generate-games.rb 不 六 好 ， 所 以 将 这 个 新 步骤 提前 。 双 击 这 个 步骤 的 标题 ， 更 改 为 Generate Test Data, 


运行 脚本 编辑 器 (如 果 它 没有 显示 出 来 ， 那 需要 单 击 提示 三 角 ) ， 它 由 3 部 分 组 成 : 


` 顶部 ， 提 供 运 行 的 脚本 。 这 里 指 的 不 是 generate-games.tb， 这 个 脚本 会 将 结果 放 入 标准 输出 ， 所 以 需要 将 它 重 定向 到 文件 
中 。 对 于 Shell 来 说 ， 对 应 的 脚本 解析 器 是 /bin/sh， 这 一 行 应 该 如 下 所 示 : 


/usr/bin/ruby "${SRCROOT} /Passer Rating"/generate-games.rb \ 
> "€{SRCROOT} /Passer Rating"/sample-data.csv 


CXERIABAREL 人 ”分 隔 ， 你 需要 将 所 有 内 容 都 放 在 一 行 忆 中 。 ) 


引号 不 可 省 略 。 脚 本 中 的 SRCROOT 变 量 会 


变量 会 被 展开 为 指向 Passer Rating 目 录 的 路 径 ， 其 
或， 所 以 需要 将 它 用 引号 括 起 来 。 


中 的 空格 会 让 脚本 解析 器 sh 产生 困 


必须 要 十 分 小 心 的 是 : 我 们 并 不 是 很 明确 每 次 传 入 到 shell 中 的 构建 变量 或 者 路 径 。 除 非 传 入 的 内 容 非 常 明确 ， 否 则 不 要 省 
略 引 号 。 


我 乙 前 见 过 这 种 错误 。 在 Generate Test Data 阶 段 会 因为 找 不 到 对 应 的 路 径 而 报错 。 经 过 一 番 修 补 ， 才 避免 了 这 个 错误 。 


接 下 来 是 一 个 输入 文件 的 表格 。 如 果 Xcode 知 道 文 件 在 什么 时 候 进 入 或 者 退出 某 个 阶段 ， 那 么 构建 系统 束 不 会 构建 那些 自打 
上 次 构建 以 来 未 发 生 更 改 的 文件 。 单 击 Input Files 列 表 下 面 的 + 按钮 ， 然 后 输入 以 下 代码 


"¢(SRCROOT) /Passer Rating"/generate-games.rb. 


. 在 输出 文件 的 地 方 ， 填 上 : 


"$ (SRCROOT) /Passer Rating"/sample-data.csv. 
这 两 种 情况 都 要 添加 引号 。 


Dire 


有 经 验 的 UNIX shell 程 序 员 可 能 对 $ (VAR) 这 种 形式 的 使 用 感到 不 安 ， 使 用 的 是 圆 括 号 而 不 是 大 括号 。 在 shell 脚 
本 中 ， 使 用 圆 括 号 会 计算 变量 的 值 并 执行 


Xcode 构建 系统 有 些 不 同 : 它 会 认为 圆 括 号 与 大 括号 的 作用 一 致 ， 
种 方法 区 分 变量 


它 总 是 要 求 你 用 茶 
分 变量 的 名 字 。 但 是 ， 当 你 的 代码 用 于 其 他 解释 器 的 时 候 ， 比 如 说 这 个 脚本 的 主体 部 分 ， 就 必须 明确 大 括号 与 圆 括号 的 
区 别 。 


执行 这 个 脚本 的 意思 是 : 


“运行 Ruby 脚 本 generate-games.rb， 将 结果 输出 到 项 目 根 目录 中 的 sample-data.csv 中 。 如 果 
这 个 输出 文件 已 经 存在 ， 而 且 比 脚本 还 要 新 ， 那 么 融 什 么 操作 都 不 执行 。 


a ` BES x 
2S ARACHAR., Z 
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为 了 这 个 用 途 ， 过 去 10 年 的 每 个 Xcode 版 本 都 是 这 样 运行 脚本 的 。 
现在 ， 你 所 要 做 的 就 是 确保 sample-data.csv 属 于 Copy Bundle Resources 构 建 阶段 的 一 部 分 ， 
Rating 应 用 的 一 部 分 。 单 击 提 示 三 


这 样 它 就 属于 Passer 
FE/JN\— 


角 ， 列 出 将 会 包含 的 文件 ， 然 后 单 击 + 按钮 添加 CSV 文 件 和 


上 人生 


取 间 


这 期 间 有 很 多 问题 。 首 先 就 是 : 当 你 将 .rb 文件 添加 到 项 目 中 时 ， 不 知道 .rb 文件 会 做 什么 ，Xcode 会 将 它 放 入 复制 资源 阶 
段 。 你 并 不 想 让 generate-games.rb 处 于 最 终 的 产品 中 。 


单 的 方法 是 : 在 列表 中 选择 对 应 的 条 目 ， 然 后 单 击 -按钮 。 
最 大 的 问题 是 鸡 生 时 还 是 恒生 鸡 的 问题 : sample-data.csv 并 不 存在 ， 所 以 无 法 将 它 放 入 列表 中 。 解 决 方法 是 执行 一 次 构建 


操作 (Product—Build, #B) 。 它 会 运行 generate-games.rb 这 个 脚本 ， 然 后 将 sample-data.csv 放 入 项 目 文件 夹 中 。 现 在 ， 
你 可 以 单 击 + 按钮 ， 然 后 单 击 Add Other... 按 钮 找到 CSV 文 件 。Xcode 会 将 这 个 文件 添加 a 到 项 目 中 ， 这 也 就 是 你 想 要 的 。 


当 一 切 设置 完毕 ， 脚 本 和 资源 构建 阶段 看 起 来 应 该 如 图 9.3 所 示 。 


¥ Generate Test Data 


Shell /bin/sh 


fusr/bin/ruby "$i{SRCROOT}/Passer Rating/generate-games. rb" 
"${SRCROOT}/Passer Ra rin0/ saapi e—-data.csv" 


EJ Show environment variables in build log 


Run script only when installing 


“$(SACROOT)/Passer Rating/generate-games.rb" 


S(DERIVED_FILE_DIR}/myfile 





¥ Copy Bundle Resources (3 items) 


* sample-data.csv 


| Images.xcassets 








图 9.3 Generate Test Data 和 Copy Bundle Resources 构 建 阶段 中 设置 了 运行 脚本 genetate-games.tb， 并 生成 sample-data.csv， 之 后 生成 
的 文件 会 被 复制 到 成 品 Passer Rating 中 。IMain.storyboard 中 显示 为 红色 ,这 是 因为 Xcode 无 法 追踪 storyboard 文 件 ， 这 点 无 关 紧 要 


Xcode 将 Ruby 和 和 CSV 文件 都 标记 为 包含 在 源 代码 管理 仓库 中 ， 在 Project 导 航 器 中 ， 这 些 文件 名 称 的 芳 边 都 会 有 一 个 A 标 
记 。 
9.4.4 源 代码 控制 和 产品 文件 


严格 来 说 ，sample-data.csv 是 一 个 产品 文件 ， 完 全 可 以 由 generate-games.rb 重 新 生成 。 没 有 必要 将 脚本 中 涉及 的 每 一 点 
都 作为 重要 的 源 代 码 管理 事件 。 它 不 应 该 放 入 源 代码 仓库 中 。 


但 是 ， 我 们 仍然 要 包含 这 个 文件 ， 用 于 前 述 第 15 章 中 的 集成 构建 阶段 。 


如 果 你 之 前 遵循 了 正确 的 方法 ， 那 么 你 会 发 现 ， 在 Xcode 的 菜单 命令 、File 查 看 器 、Commit 编 辑 器 中 找 不 到 对 应 的 操作 ， 
也 就 是 说 在 Xcode 中 无 法 完成 这 个 操作 ， 不 得 不 打开 Terminal。 


第 一 步 是 阻止 Xcode 在 下 一 次 提交 的 时 候 包含 sample-data.csv 文 件 。 告 诉 Git 将 这 个 文件 从 暂 存 区 域 (staging area) 中 移 
除 。 


$ git status 

# On branch master 

# Changes to be committed: 

# (use "git rm --cached <file>..." to unstage) 


# new file: sample-data.csv 


$H The offending file is there 
$H and Git gives a hint on how to remove it: 


$ git rm --cached sample-data.csv 


$# That took care of it for now: 

# On branch VersionControl 

# Changes to be committed: 

# (use "git rm <file>..." to unstage) 


sample-data.csv isn't there ... 
. but it is here: 


Untracked files: 
(use "git add <file>..." to include in what will be committed) 


sample-data.csv 
./Passer Rating.xcodeproj/project.xcworkspace/xcuserdata/ 


# 

# 

# 

# 

Git 会 很 小 心 谨慎 ,但 是 它 并 不 会 存心 刁难 用 尸 。 当 你 询问 工作 目录 的 状态 时 ， 它 会 列举 下 次 提交 包含 的 文件 ， 但 是 它 也 会 
告诉 你 如 何 移 除 一 个 文件 。 一 旦 这 样 做 ，Xcode 束 会 将 sample-data.csv 标 记 为 ? ， 这 个 标记 人 至 少 意味 着 这 个 文件 不 会 被 自动 提 
交 ，Git 将 这 种 状态 称 为 “未 追 哮 ”。 


久 也 就 是 你 所 需要 的 ， 但 是 这 些 文件 会 积累 在 Commit 编 辑 器 中 的 边栏 中 ， 尽 管 Xcode 希望 你 能 温和 一 些 ,， 但 是 纷 杂 的 信息 
会 掩盖 掉 重 要 的 信息 ， 所 以 你 可 能 不 想 在 源 代 人 码 管理 列表 中 再 看 到 这 个 文件 ， 或 者 任何 .csv 文 件 。 第 7 章 中 你 曾经 见 过 .gitignore 
这 个 文件 ， 这 里 又 会 再 次 看 到 。 


$ # Make sure you're in the same directory as 
$ # the .git local-repository directory 
$ 1 


Passer Rating 
A Passer Rating.xcodeproj 
-.DS_Store Passer RatingTests 


ap ho run_mogenerator.sh 
-gitignore 


$ # append something to the .gitignore file 
$ # (which will be created if it isn't there) 
$ cat >> .gitignore *.csv xcuserdata/ <AD> 


这 个 文件 的 用 途 就 是 告诉 Git (和 Xcode) ， 当 它们 检索 源 代码 仓库 中 文件 状态 的 时 候 ， 不 要 提 及 任何 与 .csv 相 关 的 文件 。 我 
还 添加 了 xcuserdata/ 这 个 目录 。 它 保 仔 了 一 些 信息 ， 特 别 是 与 项 目 有 天 的 信息 : 从 schemes 到 断 点 列表， 到 你 最 后 一 次 在 
Project 导 航 器 中 选择 的 文件 。 如 果 需 要 让 一 些 重要 的 文件 对 所 有 用 户 可 见 ， 可 以 将 重要 的 文件 标记 为 shared。Xcode 并 不 会 将 
每 一 个 选项 卡 选 择 都 视 为 重要 的 源 代 码 控制 事件 。 


七 能 正常 工作 吗 ? 


$ git status 
# On branch master 
# Changes to be committed: 


. Still no sample-data.csv .. 
# Untracked files: 
# (use "git add <file>..." to include in what will be committed) 
H 
H 


.gitignore 

. none here, either ... 
$H (Let's make sure the .gitignore file sticks around:) 
$ git add .gitignore 


我 不 会 深入 到 我 构建 的 CSV 解 析 器 (SimpleCSVFile) 的 细节 之 中 ， 同 时 我 添加 到 Passer 和 Game 中 的 代码 会 让 它们 成 为 解 
析 器 的 客户 痕 。 如 果 你 需要 了 解 这 些 细节 ， 去 查看 示例 代码 。 应 用 程序 设 定 了 委托 ， 这 样 当 App 局 动 的 时 候 ， 它 束 会 从 CSV 中 载 
入 Core Data。 


9.5 ”让 模型 更 容易 调 远 


现在 ， 你 已 经 运行 了 带 有 从 模板 中 导出 的 数据 模型 的 Passer Rating 应 用 程序 。 应 用 程序 的 文档 目录 下 有 一 个 
Passer_Rating.sqlite 文 件 。 如 果 其 中 的 内 容 与 当前 托管 的 对 象 模型 (mom) 不 匹配 ，Core Data 将 会 提示 错误 ， 同 时 应 用 程序 
Raia (实际 上 是 模板 中 的 代码 导致 了 程序 的 朋 溃 ) 。 


但 是 你 已 经 更 改 了 模型 ， 在 其 中 添加 了 Passer 和 Game， 将 来 可 能 还 会 修改 。 


我 的 经 验 是 ， 在 开发 的 早期 阶段 ， 每 次 运行 的 时 候 都 删除 .sqlite 数 据 文件 。 当 然 ， 最 后 你 会 想 要 保存 持久 数据 ， 不 过 这 是 让 
你 摆脱 头痛 的 最 简单 快速 的 万 法 。 


找到 PRAppDelegate.m 文 件 中 的 -persistentStoreCorrdinator 方 法 ， 在 storeURL 的 声明 后 面 添加 一 些 代 码 。 


if _persistentStoreCoordinator == nil { 
let storeURL = self.applicationDocumentsDirectory 
. URLByAppendingPathComponent ("Passer_Rating.sqlite") 
#if ALWAYS DELETE STORE 
// For ease in debugging, always start with a fresh data store. 
NSFileManager.defaultManager().removeItemAtURL(storeURL, error: nil) 
#endif 


Swift 没有 像 C 语 言 家 族 的 那 种 预 处 理 器 。 没 有 宏 ， 之 前 Objective-C API 使 用 #qdefine 定 义 的 符号 都 会 转换 为 Swift 常量 。 这 
其 中 有 一 个 例外 : 你 可 以 使 用 #if...#end 判 断 是 否 包含 某 些 代码 。 


但 是 不 能 像 C 语 言 中 那样 随便 使 用 : 不 要 使 用 #if 0 临时 取消 某 些 代码 ， 但 是 仍然 让 这 些 代码 存在 于 源 文 件 中 。#if 语 句 没 有 
值 ; 没有 对 比 或 者 数学 运算 ; 参数 既 没有 被 定义 (暴露 #if 语 句 块 中 的 内 容 ) 而 且 也 没有 (在 编译 器 中 隐藏 它们 ) 。 同 时 ， 你 唯 
一 可 以 定义 它 的 方法 是 作为 构建 设置 (或 者 swiftc 工 具 的 命令 行 参 数 ) 。 


打开 Target 编 辑 器 的 Build Phases 选 项 卡 ， 搜 索 Other Swift Flags。 通 常 搜索 结果 为 空 。 双 击 Passer Rating target 的 设置 
区 域 ， 然 后 输入 -D ALWAYS DELETE STORE， 这 样 束 允许 在 程序 代码 中 使 用 removeltemAtURLi 语 句 。 


9.6 Me 


你 已 经 开始 认真 构建 iDOs 应 用 程序 。 学 习 了 如 何 使 用 Data Model 编 辑 器 构建 ， 添 加 了 你 自己 设计 的 Core Data 托 管 对 象 模 


型 ， 让 实体 能 够 描述 数据 类 型 ， 并 给 它们 添加 了 有 具有 合适 类 型 和 限制 的 属性 。 同 时 ， 你 还 奶 踪 了 实体 之 间 的 关系 ， 让 它们 能 表示 
Passers 参 加 Games 的 关系 。 


当 写 下 第 一 行 代 码 时 ， 你 就 距 数 据 模型 更 近 了 一 步 。 利 用 Xcode 从 实体 中 构建 了 NSManagedOject 的 子 类 ， 同 时 从 数据 记 
录 中 生成 了 第 一 类 对 象 。 


最 后 ， 为 了 测试 数据 ， 你 第 一 次 见 到 了 Target 编 辑 器 中 的 Build Phases 选 项 卡 。 添 加 了 生成 测试 数据 的 脚本 步骤 ， 然 后 将 这 
个 步骤 添加 到 构建 流程 中 ， 这 样 束 能 按 需 生成 对 应 的 数据 了 。 


第 10 草 ”10S 应 用 程序 : 控制 器 


如 果 之 前 我 够 聪明 ， 那 么 会 在 模型 第 一 稿 完 成 之 后 ， 赶 在 复杂 的 人 机 交互 层 之 前 残 开始 单元 测试 。 但 是 我 没 那 么 聪明 ， 所 以 
我 打算 将 测试 推迟 到 第 15 章 。 


现在 ， 带 着 我 们 第 一 款 粗 烟 的 App 继 续 前 进 。Xcode 的 Master-Detail Application 模 板 提 供 了 第 一 张 表 的 工作 版 本 。 让 我 
们 将 它 转化 成 四 分 卫 和 对 应 评分 的 表格 。 


还 记得 8.1.4 节 的 内 容 吧 ，iOS 应 用 程序 中 的 全 屏 视 图 由 视图 控制 器 (view controller) 管理 ， 它 是 UIViewController 的 子 
类 。 带 有 预定 义 方法 的 iOS 服 务 视图 控制 器 的 调用 贯穿 于 视图 的 整个 生命 周期 : 载 入 、 事 件 响应 和 年 [ 载 。 提 供 支 持 这 些 方 法 的 


UIViewController 类 是 你 的 责任 。 在 本 重 中 ， 我 将 会 完善 初始 的 控制 器 ，MasterViewController。 


局 注意 ”再 强调 一 遍 ， 我 不 会 提供 将 会 用 到 的 文件 的 完整 列表 。 项 目 模板 提供 了 很 多 我 不 会 列 出 来 的 文件 ， 实 际 上 这 些 文 
件 都 在 你 面前 ， 剩 下 的 部 分 可 参照 从 前 言 指引 中 可 获得 的 示例 代码 。 注 意 ， 示 例 代 码 文件 夹 并 不 包含 Git 代 码 仓库 ， 请 把 这 些 示 
例 代码 仅 作为 参考 。 从 你 自己 的 版 本 管理 文件 夹 切 换 到 示例 代码 文件 夹 将 会 导致 代 码 丢 失 。 


10.1 Objective-C 中 的 符号 重合 


在 本 节 中 ， 我 想 先 回 到 本 书 上 一 版 Objective-C 版 本 的 Passer Rating 应 用 程序 中 。 因 为 Xcode 提供 了 强大 的 重 构 工具 ， 使 用 
Xcode 深 入 代码 中 做 出 明智 的 修改 。 问 题 是 现在 这 些 工具 只 有 ObjC 的 版 本 。 当 然 早晚 会 文 持 9wift， 但 是 现在 还 没有 。 假 设 现在 
我 们 使 用 的 还 是 Passer.h，Passer.m 以 及 相关 的 Objective-C 类 。 


在 类 Passer 的 第 一 个 版 本 中 ， 我 有 一 个 构造 国 数 ， 一 个 名 为 quarterbackWithFirstName:last:inContext 的 类 方法 。 这 人 么 做 
是 错误 的 。 根 据 Cocoa 的 约定 ， 快 捷 构 造 国 数 应 该 以 类 名 开头 ， 所 以 我 癌 得 用 last 命 名 是 一 个 很 不 好 的 风格 : 当 参 数 设 置 了 一 个 
名 为 lastName 的 属性 时 ， 它 应 该 像 这 样 : passerWithFirstName:lastName:inContext:, 


10.1.1 ” 重 构 Objective-C 方 法 名 


之 前 在 第 7 章 中 ， 你 曾经 做 过 全 局 搜索 和 替换 操作 。 这 一 次 需要 找到 quarterback WithFirstName 的 每 个 实例 和 子 字符 串 
passerWithFirstName:lastName:inContext 的 全 部 实例 ， 对 吧 ? 


没有 这 么 迅速 。 小 心 处 理 选择 器 的 第 二 部 分 ， 它 意味 着 要 检查 每 个 市 有 last: 的 实例 ， 确 保 选 中 的 是 


quarterbackWithFirstName:last:inContext。 为 了 正确 起 见 ， 一 次 搜索 会 调用 正则 表达 式 来 匹配 所 有 相符 的 字段 ， 同 时 也 只 有 
这 些 字 符 串 的 使 用 是 这 个 方法 的 选择 器 。 这 融 是 这， 计算 各 个 部 分 之 间 的 参数 ， 一 次 调用 可 能 横 跨 好 几 行 ; 插入 行 和 限定 了 的 注 
释 。 在 @selector 表 达 式 中 使 用 空 选择 器 ， 同 时 要 防止 更 改名 为 quarterbackWithFirstName:last'team:inContext: 的 方法 。 


如 果 你 是 正则 表达 陈 的 狂热 分 子 ， 你 可 能 会 使 用 查找 并 蔡 换 这 个 功能 。 但 是 手动 格式 化 并 确定 全 部 符合 条 件 的 字符 串 将 会 耗 
费 大 量 时 间 。 重 构 能 很 好 地 完成 这 个 工作 。 


quarterbackWithFirstName:last:inContext: 第 一 次 声明 在 PRPasser.h 中 ， 定 义 在 PRPasser.m 中 。 打 开 任 意 一 个 文件 ， 单 
击 方 法 名 中 的 任意 一 个 地 方 ， 选 择 Edit 一 Refactor 一 Renamehttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...。 


弹出 的 界面 中 仅 市 有 原来 的 选择 器 。 当 你 在 选择 器 中 编辑 的 上 时候， 你 会 友 现 Xcode 并 不 会 接受 新 名 字 一 一 它 会 报错 
非 它 有 与 原始 选择 器 相同 数量 的 冒号 。Xcode 这 么 做 也 有 道理 ， 如 果 参 数 不 同 ， 融 没有 办 法 重新 区 分 它们 。 


除 





单 击 Preview 按 钮 ， 在 对 比 界面 中 检查 这 些 改动 (Xcode 可 能 会 为 项 目 提供 第 7 章 中 提 到 的 快照 ) 。 符 号 的 每 次 使 用 一 一 声 
明 、 定 义 以 及 调用 ， 无论 是 在 一 行 还 是 多 行 中 一 一 都 会 被 更 改 。Xcode 之 所 以 能 做 到 这 一 点 是 因为 重 构 这 个 功能 完全 没有 依赖 
搜索 : 它 拥 有 所 有 符号 使 用 的 这 引 ， 所 以 它 能 忽略 空格 和 参数 引起 的 问题 。 


单 击 Save 按 钮 ， 然 后 将 更 改 提交 到 版 本 管理 (是 的 ， 真 的 是 。 当 你 每 次 修改 了 代表 单一 逻辑 的 一 组 文件 时 ， 都 应 该 提交 这 
些 文件 。 如 果 你 频繁 地 提交 ， 这 些 提交 日 志 束 会 反映 出 你 的 意图 ， 而 不 仪 仪 是 备份 列表 ) 。 


10.1.2 重 构 类 名 


这 里 还 有 另外 一 个 命名 问题 ，MasterViewController 类 。 这 个 类 名 由 项 目 模 板 提 供 ， 这 个 名 字 也 有 一 定 的 摘 述 性 ， 但 是 它 
摘 述 的 是 类 的 角色 ， 而 不 是 这 个 类 本 身 的 功能 。 这 个 类 中 包含 了 一 个 传 球 手 列 表 ， 所 以 类 名 应 该 反映 出 这 一 点 : 
PasserListController。 这 是 要 用 到 名 称 重 构 工具 的 另外 一 种 情况 。 


这 个 需求 能 通过 查找 -替换 功能 完成 吗 ?” 查 找 - 蔡 换 并 不 能 很 好 地 胜任 这 个 工作 。 比 如 ，MasterViewController 可 能 是 其 他 
符号 的 子 字符 串 ， 虽 然 本 例 中 并 未 出 现 这 个 情况 。 


还 有 一 个 原因 ，MasterViewController 这 个 名 字 并 不 仪 仪 存在 于 文件 中 。iOS 应 用 程序 在 .nib 和 .storyboardc 文 件 中 一 一 对 
象 文档 一 一 它们 通过 .xib 文 件 引 用 类 ， 从 Xcode 编译 的 NIBs、.storyboard 文 档 ，.storyboardc 从 这 些 文档 中 派生 ， 最 后 生成 
XML 文 件 。 但 是 XML 显 然 不 适合 人 读 取 ， 所 以 你 不 得 不 求助 于 特殊 的 编辑 器 Interface Builder， 通 过 它 找 出 所 有 的 引用 。 


在 .m 或 者 .h 文 件 中 找到 MasterViewController， 单 击 这 个 字段 ， 然 后 就 像 之 前 一 样 选择 
Edit—~Refactor—Renamehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.... #%iAPasserListController, MIRAT 
Rename related filles 这 个 选项 ， 单 击 Preview 按 钮 ， 然 后 看 一 下 更 改 的 地 方 : 


- 每 一 处 MastetViewConttollef 出 现 的 地 方 ，Xcode 都 将 它 替 换 成 了 PassefListConttolletf。 之 前 你 也 见 到 了 。 
- 之 前 那些 名 为 MastetViewConttollet 的 文件 现在 都 改 为 了 PassetListConttollet。 
在 PassefListConttollef 和 AppDelegate 对 应 的 .m 文 件 中 ， 


#import "MasterViewController.h" 


已 经 改 为 了 


#import "PasserListController.h" 


也 瓯 是 襄 ， 重 命名 功能 涉及 了 项 mport 指 令 。 
Main.storyboard 中 包含 了 更 改 的 文件 列表 。 看 下 它们 之 间 的 对 比 ， 你 会 看 到 一 些 复杂 的 XML 文件 ， 同 时 类 名 的 引用 都 已 经 


被 更 改 了 。 同 时 ， 你 也 会 发 现在 XML 中 并 不 是 简单 的 搜索 替换 ， 重 构 也 编辑 了 文件 结构 ， 如 果 手 动 进行 这 个 操作 会 很 不 安全 。 


. 头 文件 注释 中 的 文件 名 并 没有 被 更 改 。 重 构 仅 对 符号 有 用 ， 对 注释 和 字符 事 不 起 作用 。Xcode 不 确定 用 户 可 读 的 内 容 中 出 


现 的 这 些 字符 哪些 是 符号 哪些 只 是 文字 。 


保存 并 提交 更 改 。 提 交 编 辑 器 会 将 PasserListController 这 个 文件 标记 为 A+， 由 此 表示 它们 已 经 按照 新 名 称 “ 添 加 ”到 了 源 
代码 管理 器 中 。 在 后 侣 ，Git 会 将 市 有 旧 文 件 名 的 文件 标记 为 “删除 ”， 然 后 添加 新 文件 名 的 文件 ， 通 过 这 种 方式 ， 旧 文件 中 的 
历史 记录 就 会 添加 到 新 文件 上 。Xcode 将 你 从 纷繁 复杂 的 细节 中 解放 出 来 了 。 


以 上 是 在 Objective-C 中 进行 重 命名 操作 ， 现 在 回 到 Swift 中 。 


10.2 ”在 Swift 中 重 命名 类 


Xcode 的 master-detall 应 用 程序 模板 为 项 目 添加 了 两 个 视图 控制 器 类 : MasterView Controller 和 DetailViewController。 
对 于 占 位 符 来 说 ， 这 样 命名 没 问题 ， 但 是 它们 没有 表明 类 的 用 途 。 


我 们 知道 这 两 个 类 的 用 途 : 其 中 一 个 用 来 列 出 passers， 另 外 一 个 用 来 列 出 games。 所 以 它们 的 名 称 应 该 为 


PasserListController 和 GameListController。 


押运 的 是 ， 虽 然 我 们 没有 重 构 工具 ， 但 是 Swift 是 一 门 简单 的 语言 ，Xcode 的 Find 导 航 器 能 够 胜任 这 个 工作 。 只 要 你 足够 细 
心 ， 你 要 做 的 仅 仪 是 全 局 查找 和 蔡 换 ， 以 及 一 个 文件 中 的 名 字 更 改 。 


在 第 7 草 中 你 已 经 见 过 了 Find 导 航 器 ， 所 以 现在 用 起 来 应 该 轻车熟路 : 单 击 导航 区 域 的 第 三 个 选项 卡 ， 然 后 在 弹出 菜单 中 选 
择 Replace 一 Text 一 Matching。 要 搜索 的 字符 串 是 MasterViewController， 茶 换 的 字符 串 是 PasserListController。 在 搜索 栏 中 
按 return 键 ， 导 舰 器 列表 中 融会 列 出 所 有 这 个 字符 串 出 现 的 地 方 一 一 你 会 友 现 即便 Main.stroyboard 中 master-controller 场 景 
中 的 名 字 也 能 检索 到 。 单 击 Replace All， 这 样 搜索 残 完 成 了 。 


重复 这 个 过 程 ， 将 DetailViewController 更 改 为 GameListController。 


现在 将 文件 重 命名 : 在 Project 导 航 器 (第 一 个 选项 卡 ) 中 单 击 文件 名 ， 然 后 将 鼠标 稍微 动 一 点 ; 或 者 选中 文件 的 时 候 直 接 
按 下 return 键 ， 都 可 以 让 文件 名 处 于 可 编辑 状态 。 输 入 基础 文件 名 PasserListController 和 GameListController， 项 目 文 件 旁 边 
会 有 一 个 M 标 记 ， 说 明 项 目 中 的 文件 上 友 生 了 更 改 ， 同 时 重 命名 的 文件 芳 边 会 有 一 个 A+ 的 符号 。 现 在 是 提交 更 改 的 代码 的 绝 佳 时 
机 。 


10.3 编辑 View Controller 


新 的 PasserListController 方 法 还 是 用 于 展示 模板 中 的 占 位 符 Event 实 体 。 这 个 方法 已 经 不 适合 现在 的 功能 ， 你 需要 将 其 蔡 换 
成 自己 的 代码 用 来 显示 Passers。 模 板 代码 中 使 用 了 NSFetchedResultsController， 这 个 工具 类 提供 了 很 多 方法 ， 可 以 用 来 将 
Core Data 对 象 分 组 、 按 列 显 示 、 排 序 和 编辑 。 


NSFetchedResultsController 是 一 个 非常 强大 的 工具 ， 不 过 在 你 能 高 效 地 使 用 它 之 前 ， 还 是 要 先 熟悉 Core Data 的 用 法 。 
Cocoa 书 籍 一 般 会 将 它 作 为 高 级 课程 ， 抓 取 结 果 的 控制 器 就 是 基于 它 构 建 。 


不 过 ,我 们 能 清理 挥 最 糟 炼 的 部 分 。Xcode 模 板 为 我 们 提供 的 用 于 master (现在 是 passer-list) 的 控制 器 太 简 单 (Event 实 
体 仅 有 一 个 属性 ) ， 同 时 也 太 聪 明 ( 它 运 用 了 大 量 技巧 让 目 己 变 得 更 通用 ) 。 我 们 要 把 这 一 部 分 删 掉 。 


我 们 可 以 采取 第 9 章 中 的 第 一 步 ， 为 NSFetchedResultsController 添 加 一 个 子 脚本 : 模板 包含 一 系列 对 
objectAtindexPath(0) 的 调用 ， 这 显得 见 余 ， 而 且 需 要 对 结果 进行 截断 。 


let object = fetchedResultsController.objectAtIndexPath (indexPath) 
as! NSManagedObject 


Swift 需要 在 属性 名 称 前 冠 以 se 上 ff， 用 来 表示 同名 的 函数 参数 ， 同 时 子 脚本 的 定义 不 仅 相 当 简洁 ， 而 且 还 能 安全 地 将 结果 转换 
为 NSManagedObject。 


let object = fetchedResultsController [indexPath] 


这 个 模板 从 fetchedResultsController 中 获取 Core Data 托 管 对 象 的 上 下 文 ， 即 便 PasserList Controller 已 经 有 了 一 个 属于 
自己 的 managedObjectContext 属 性 。 下 面 束 是 属性 的 定义 : 


Var managedObjectContext: NSManagedObjectContext? 


它 的 意思 是 说 ， 变 量 是 一 个 可 选 的 NSManagedObjectContext， 因 为 它 初 始 的 时 候 是 nil， 然 后 等 待 AppController 初 始 化 
。 之 后 对 这 个 属性 的 引用 ， 需 要 使 用 ! 操作 符 解 包 : managedObjectContext!, 


(\} 


CHAGOO BH, AARSAW (至 少 我 们 希望 ) 属性 总 是 在 使 用 之 前 被 初始 化 。 将 声明 更 改 为 : 
var managedObjectContext: NSManagedObjectContext! 


这 样 你 束 不 需要 上 自己 解 包 。 市 有 不 是 必需 的 可 选 值 处 理 的 代码 很 难 阅读 。 它 允许 你 将 


let context = fetchedResultsController.managedObjectContext 


转化 为 


let context = managedObjectContext 


这 样 就 减少 了 代码 量 ， 因 为 不 需要 使 用 一 个 context 变 量 来 “简化 ”从 获取 结果 的 控制 器 中 得 到 值 。 


10.3.1 RWE 


PasserListController 是 UlTableViewController 的 子 类 ， 它 本 身 是 UlIViewController 的 子 类 ， 用 来 管理 组 成 表 的 界面 的 细 
节 信 息 。 表 视图 通过 委托 模式 (Delegate) 填充 这 些 表 视 图 : 表 提 供 了 大 部 分 用 户 端 的 行为 ， 然 后 回调 到 控制 器 (或 者 其 他 对 
象 ) 一 一 委托 一 一 由 此 为 特定 用 途 的 表 提 供 细 节 内 容 。UlTableView 本 身 并 不 保存 任何 数据 信息 ， 而 是 从 数据 源 委 托 对 象 中 获 
取 。 


全 注意 事实 上 ,UTTableView 有 两 种 委托 : 名 为 dataSource 的 委托 用 来 提供 内 容 ; 另外 一 个 delegpte 用 来 提供 表 级 别 的 操 
作 ， 比 如 插入 和 删除 元 素 。 


数据 源 创 建 了 一 些 元 素 ， 用 来 组 成 表 的 行 。 它 创建 了 UITableViewCells， 然 后 给 它们 填充 了 数据 。 通 常 ， 只 有 在 表 查 询 行 
的 时 候 (调用 方法 tableView(_,cellForRowAtindexPath:)) 才 会 这 么 做 。 从 模板 元 素 中 创建 的 控制 器 会 将 元 素 填充 到 自 定义 的 
configureCell(cell:,atiIndexPath:) 方 法 中 。 找 到 这 个 方法 ， 将 它 蔡 换 成 : 


func configureCell(cell: UITableViewCell, 
atIndexPath indexPath: NSIndexPath) { 


let passer = fetchedResultsController[indexPath] as! Passer 
cell.textLabel.text = "\(passer.firstName) " + 
"\ (passer.lastName) " + 


"\ (passer.passerRating) )" 


indexPath 标 识 了 单元 格 代表 的 是 哪 一 部 分 (在 这 个 简单 的 列表 中 通常 是 0) 或 者 行 。NSFetchedResultsController 中 我 们 
创建 的 子 脚本 方法 可 以 很 简单 地 找 出 匹配 的 Passer。 这 个 方法 使 用 passer 的 名 字 和 评分 填充 单元 格 的 文本 。 


10.3.2 构建 Passer List 


fetchedResultController 方 法 发 起 了 一 个 拉 取 请 求 (如 果 你 了 解 SQL， 那 么 可 以 将 它 想 象 成 SELECT 操作 ) ， 这 个 操作 会 摘 
述 视图 控制 器 中 显示 的 对 象 并 将 其 排序 。 这 里 有 两 个 修改 。 模 板 提 供 的 代码 非常 “聪明 ”， 这 个 方法 相当 通用 ; 根据 我 们 对 
Passer 的 了 解 ， 使 用 我 们 创建 的 快捷 方式 ， 可 以 将 代码 简化 为 : 


var fetchedResultsController: NSFetchedResultsController { 
// Already there? Return it. 
if let existing = _fetchedResultsController { return existing } 


// Set up the fetch request (think SELECT in SQL) for 
// the contents of the table. 

let fetchRequest = NSFetchRequest (entityName: "Passer") 
fetchRequest.fetchBatchSize = 20 


// Order by last name, then first. 
fetchRequest.sortDescriptors = [ 
NSSortDescriptor (key: "lastName", ascending: true), 
NSSortDescriptor(key: "firstName", ascending: true) 


// Create the fetched-results controller. 
_fetchedResultsController = NSFetchedResultsController ( 
// Passer, ordered last name, first 
fetchRequest: fetchRequest, 
// In my context 
managedObjectContext: managedObjectContext, 


// No sections 

sectionNameKeyPath: nil, 

// Generic name for the cache 

cacheName: "Master") 
_fetchedResultsController!.delegate = self 


// The fetch doesn't work? Bail. Don't try this at home. 

var error: NSError? = nil 

if !_fetchedResultsController!.performFetch(&error) { 
abort () 


return _fetchedResultsController! 


} 
var _fetchedResultsController: NSFetchedResultsController? = nil 


10.3.3 “新建 Passer 


单 击 位 于 表 上 侧 导 航 栏 的 + 按钮 ， 融 会 调用 insertNewObject 方 法 ， 这 个 链接 人 在 viewDid Load 中 生成 。 中 间 部 分 代码 在 数 
据 库 中 插入 了 一 个 Event 并 设置 了 时 间 戳 。 模 板 提 供 的 insertNewObject 方 法 会 将 实体 ( 表 ) 从 fetchedResultsController 中 取 
出 ， 然 后 用 它 初始 化 新 对 象 。 


这 么 做 很 取 明 ， 但 是 你 已 经 有 了 一 个 生成 器 用 于 生成 Passer 实 例 ， 避 免 了 大 量 繁琐 的 操作 。 将 方法 的 主体 部 分 蔡 换 为 : 


func insertNewObject(sender: AnyObject) { 
// Create using mogenerator's convenience initializer 
let newPasser = Passer ( 
moc: managedObjectContext) 


// We added a default-value dictionary and 

// away to initialize a Passer from it: 

newPasser.setValuesForKeysWithDictionary ( 
newPasser.defaultDictionary) 


// Save the context. 


var error: NSError? = nil 
if !managedObjectContext.save(&error) { 
abort () 


2A} Passer IA PANS FAAHAERE, BEBELE k PERLE, Zee. 


期 问题 及 处 理 方法 





现在 已 经 做 了 一 些 实质 性 的 更 改 ， 我 想 看 看 这 些 更 改 是 否 能 够 通过 编译 器 的 检查 。 在 传统 的 工作 沅 中 一 一 如 果 你 听从 了 我 
在 第 2 草 2.2.2 节 中 的 建议 ， 那 么 现在 你 束 处 于 传统 的 工作 流 中 ， 你 需要 通过 编译 检查 来 运行 这 个 文件 。 


Xcode 6 中 有 一 个 命令 : 选择 Product 一 Perform Action 一 Compile 丈 会 仅 编译 当前 编译 器 中 的 文件 ， 而 不 会 重新 编译 整个 


项 目 。 选 择 这 个 命令 需要 进入 两 级 目录 ， 不 过 你 可 以 使 用 偏好 窗口 中 的 Key Bindings 面 板 为 这 个 命令 指定 一 个 快捷 键 。 


如 果 你 选择 使 用 这 个 命令 ， 并 与 我 已 经 保持 同步 (如果 没有 ， 那 么 去 获取 示例 代码 ) ， 现 在 应 该 没有 任何 错误 ,不 过 在 
insertNewObject 中 还 是 有 一 条 警告 信息 一 一 Incorrect argument label in 


call (have ‘moc:” ,expected ‘managedObjectContext: ) 。 解 决 方法 很 简单 ， 就 像 它 说 的 那样 ， 使 用 
managedObjectContext 蔡 损 moc。 


还 有 一 种 方法 也 可 以 做 到 这 一 点 ， 也 是 大 多 数 人 更 喜欢 的 主流 做 ) 去 。 在 第 2 章 中 ， 我 曾经 打开 过 Preferences 窗 口 、General 
面板 ， 没 有 勾 选 Show live issues。 现 在 重新 勾 选 这 个 选项 。 


现在 如 何 ” 应 该 没有 什么 问题 了 了。 将 试 撤销 将 moc 更 改 为 nanagedObjectContext 这 一 行 。 而 此 时 并 不 需要 你 重新 编译 这 
个 文件 ， 和 警告 束 会 重新 出 现 。 现 在 你 会 注意 到 一 些 事情 : 边栏 空 日 处 表示 错误 的 红色 标记 通 党 包含 一 个 “! ”， 这 个 标记 有 一 个 
日 色 的 点 号 。 


单 击 红 色 的 标识 ， 就 会 出 现 一 个 Fix-it 的 弹出 框 ， 里 面 显示 的 是 修复 过 错误 (或 者 至 少 在 后 面 的 代码 之 中 也 会 修改 的 ) 之 后 
的 源 代码 ， 见 图 10.1。 在 这 个 例子 中 ， 仪 包含 一 个 选项 ， 但 它 刚好 是 正确 的 哪 一 个 选项 : 将 moc 更 改 为 managedObject- 


Context。 如 果 有 多 个 可 选项 ， 你 需要 从 中 做 出 选择 。 高 之 的 部 分 表示 米 取 对 应 的 更 改 后 的 代码 。 按 下 return 键 或 者 双击 高 亮 的 
建议 部 分 束 可 以 接受 对 应 的 更 改建 议 。 


func insertNewObject(sender: AnyObject) i 
/f Create using mogenerator’s convenience initailizer 
Let newPasser = Passer( © Incorrect argument label in call (have ‘moc:’, ex... 
Ws Manna ygedOw jealCunleal) 


/f We added a default-value dictionary and 
YY away to initialize a Passer from it: 
newPasser,.dictionaryRepresentation = 














ug func insertNewObject(sender: AnyObject) + 

50 // Create using mogenerator s convenience initailizer 

5] Let newPasser = Passer © Incorrect argument label in call (have ‘moc’, Bx... 
52 managedObjectConte t: managedObjectContext) 

33 Issue incorrect argument label in call (have 'moc:', expected ‘managedObjectContext: " 

Fix-it Feplaca “moc” with “managedObjectCortext” | 





一 —-—S —— — E 一 


90 newPas ser.:-dictionar YRepr Psentatltlon = 


图 10.1 CE) 部 分 Swift 错误 包含 的 是 一 个 点 号 而 不 是 感叹 号 。 (F) 单 击 点 号 就 会 弹出 一 个 Fix-it 的 弹出 按钮 ， 给 出 错误 的 修改 
建议 。 建 议 的 修改 会 在 代码 中 暂时 出 现 


对 于 C 语 言 家 族 来 说 ，Fix-it 功 能 使 用 llvm 库 深入 代码 内 部 ， 检 查 是 什么 引发 了 问题 代码 。 比 如 说 ， 下 面 是 C 编 程 中 常用 的 循 
环 方 法 : 


int ch; 
while (ch = getchar()) 
putchar (ch) ; 


但 是 在 Boolean 上 下 文中 使 用 赋值 操作 (=) 的 做 法 不 太 好 ， 比 如 上 面 的 while 语 句 。 原 打算 执行 等 值 测试 (==) 但 实际 却 
执行 了 赋值 操作 ， 这 是 一 个 非常 常见 的 错误 。 当 开启 了 不 匹配 的 括号 (missing-braces-and-parentheses) 警告 时 ，Xcode 会 
爹 测 到 你 要 么 是 赋值 要 么 是 比较 ， 同 时 Fix-itj 单 出 框 会 分 别 为 这 两 种 情况 提供 对 应 的 解决 方案 ， 见 图 10.2。 


int main(int argc, const char * argvl[]) i 
int ch: 
while (ch = getchar(}) 
putcha (ch): 
Issue Using the result of an assignment as a condition without parentheses 


Fx-it Place parentheses around the assignment to silence this warning 


Fix-it Use '==" to turn this assignment into an equality comparison |. 





410.2 ” 当 有 多 个 可 用 的 解决 方案 时 (就 像 在 while 循 环 中 的 赋值 操作 ) ，Fix-it 就 会 提供 可 选 方案 ， 并 说 明 什么 才 是 正确 的 代码 


10.5 ”真正 的 Passer Rating 


如 果 一 切 顺 利 ， 你 手中 惑 不 再 是 一 个 模板 应 用 程序 : 你 会 有 一 个 应 用 用 于 计算 并 展示 passer ratings。 让 我 们 尝试 下 。 选 择 
Product 一 Run (ÆR) 。 


10.5.1 另外 一 个 bug 


现在 你 会 知道 为 什么 我 这 “如 果 一 切 顺 利 ， 因 为 这 个 应 用 将 会 朋 演 。Debug 导 航 器 的 异常 处 理 程序 显示 了 一 些 奶 路 信 
息 ， 在 控制 台中 会 看 到 |: 
Terminating app due to uncaught exception 'NSInvalidArgumentException', 


reason: 'xx* - [NSDictionary initWithObjects:forKeys:]: 
count of objects (1) differs from count of keys (12)' 


这 段 信息 后 面 是 一 系列 堆 枝 信息 ， 最 后 一 条 是 … 一 个 非 惠 长 的 符号。 通过 珊 悉 的 子 字符 串 3impleCSVFile， 你 会 友 现 它 己 你 
的 代码 相关。 与 C++ 一 样 ，Swift 通 过 “混合 ”名 称 来 确定 函数 所 在 的 类 、 参 数 类 型 以 及 返回 值 。 这 上 绎 都 是 肉眼 不 可 读 的 。 


平 运 的 是 ，Xcode 工 具 链 中 有 一 个 反 混 合 的 工具 ， 你 可 以 在 命令 行 中 运行 这 个 工具 ( 反 和 斜 杠 的 使 用 是 因为 篇 幅 的 限制 ， 缩 进 
是 实际 使 用 中 残 有 的 ) 。 


$ xcrun swift-demangle _TFC13Passer_Rating13SimpleCSVFile3runfs0_\ 
FFGVSs10DictionarySSSS_GSqCSo7NSError _GSqOS_8CSVError_ 


_TFC13Passer_Rating13SimpleCSVFile3runfS0_FFGVSsl10Dictionaryssss_\ 
GSqCSo7NSError_GSqOS 8CSVError_ ---> 


Passer_Rating.SimpleCSVFile.run (Passer_Rating.SimpleCSVFile) 
(([Swift.String : Swift.String]) -> ObjectiveC.NSError?) 
-> Passer _Rating.CSVError? 


很 高 兴 我 们 能 知道 SimpleCSVFile.run (block:) 中 友 生 了 什么 问题 ， 但 是 当 应 用 程序 运行 过 后 ， 这 些 信息 融会 消失 。 如 果 
信息 能 保存 下 来 就 太 好 了 。 


One ”异常 是 程序 水 自己 的 程序 或 者 系统 程序 _ 的 信号 灯 ， 它 意味 着 程序 出 现 了 问题 。 当 触发 一 个 异常 的 时 
候 ， 程 序 会 停 在 最 近 处 理 这 个 异常 的 位 置 。 如 果 没 有 处 理 这 个 异常 的 代码 ， 那 么 最 后 将 会 导致 程序 终止 运行 ， 本 例 就 属于 这 种 情 





况 。 其 他 编程 语言 的 程序 员 通 常会 使 用 异常 作为 常规 的 结构 控制 方法 。Cocoa 会 因为 性 能 和 稳定 性 的 原因 避免 使 用 它们 。Swift 中 
基本 不 会 用 到 。 在 Cocoa/Objective-C/Swift 中 ， 只 有 在 条 件 紧急 ， 有 可 能 会 危害 到 应 用 程序 及 对 应 数据 完整 性 的 情况 下 ， 才 会 用 


到 异常 。 


有 一 种 方法 可 以 做 到 这 一 点 ， 打 开 Breakpoint 导 航 器 ， 它 会 显示 项 目 中 全 部 断 点 。 断 点 并 不 限于 通过 在 产 代 码 空 日 处 单 击 
创建 的 断 点 ; MA, MATURE aA (exception breakpoint) ， 当 发 生 异 党 的 时 候 ， 这 类 断 点 会 阻止 程序 继续 执行 。 


在 Breakpoint 导 航 器 的 左下 角 有 一 个 + 按钮 ， 单 击 这 个 按钮 ， 残 会 弹出 一 个 菜单 ， 其 中 包含 一 个 选项 Add Exception 
Breakpointhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., All exceptions 断 点 都 会 出 现在 这 个 列表 中 。 
你 可 以 选择 配置 它 ( 右 击 ， 或 者 使 用 Option-Command-click， 就 能 看 到 一 个 弹出 界面 ) ， 但 是 默认 的 行为 已 经 足够 使 用 。 


StS 有 一 种 情况 需要 编辑 断 点 ， 那 就 是 去 除 C++ 异 常 ， 一 些 OS 库 会 定期 使 用 。 
设置 了 异常 断 点 后 ， 再 次 运行 Passer Rating。 现 在 当 出 现 异 常 的 时 候 ， 调 试 器 中 就 会 显示 程序 最 后 运行 时 的 代码 。 


let values = NSDictionary (objects: fields, 
forKeys: headers) 
as! [String: String] 


同时 ，Debug 导 航 器 的 运行 栈 中 也 会 看 到 之 前 在 控制 台 看 到 的 缺少 括号 的 错误 。 几 乎 忌 是 这 样 。 


堆栈 信息 占据 了 Debug 导 航 器 的 大 部 分 空间 ， 从 下 到 上 依次 显示 了 从 start 水 数 开始 到 月 江 或 者 断 点 所 在 遂 数 之 | 间 的 所 有 泛 
数 信 息 。 你 写 的 遂 数 以 两 种 方式 高 亮 显示 : 首先 销 数 名 称 为 黑色 而 不 是 灰色 ， Xcode 通过 这 种 方式 标识 这 些 消 数 都 能 看 到 源 代 
码 。 


其 次 ， 这 尝 函 数 都 会 旁 都 有 一 个 监 色 的 图 标 ， 图 标 上 市 有 Apple 目 定义 专门 用 来 代表 “用 尸 ” 的 小 人 图 像 。 这 个 图 标 表示 框 
架 、 函 数 的 来 源 。 还 有 一 些 例子 比如 专门 用 于 表示 Cocoa 框 如 的 紫色 杯子 ，Foundation 和 Core Foundation 的 函数 下 都 有 橄榄 
色 的 虚线 〈 它 可 能 用 来 表示 传 瓦 的 虚线 ) ; event-servicing frameworks (事件 服务 框架 ) 会 用 深 粉 色 的 公文 包 标记 ， 运 行 时 
库 用 深 棕色 的 圆 标 记 。 


我 们 并 不 是 对 所 有 上 逆 数 都 有 兴趣 。 有 很 多 调用 都 涉及 Cocoa 内 部 机 制 ， 并 不 台 道 调用 从 哪里 开始 ， 也 不 知道 嚼 数 调用 的 具体 
过 程 以 及 它 在 哪里 朋 演 ,纠缠 于 Cocoa 内 部 的 细节 并 没有 多 大 好 处 。Xcode 对 这 些 内 容 了 如 指 擎 。Debug 导 航 器 的 左下 角 是 一 
个 按钮 ， 见 图 10.3。 它 能 过 滤 一 些 栈 信息 ， 当 这 个 按钮 高 亮 的 时 候 ， 仪 能 看 到 调试 符号 帧 ,或 者 库 之 间 的 控制 传递 ， 当 按钮 变 
灰色 的 时 候 ， 束 能 看 到 所 有 的 信息 。 


调试 器 ， 克 其 是 异 单质 述 部 分 会 告诉 你 需要 的 信息 : 还 记得 最 后 锐 执 行 的 代码 是 哪 行 吧 。 


let values = NSDictionary (objects: fields, 
forKeys: headers) 
as! [String: String] 


这 条 异常 信息 是 说 12 个 key 仪 有 一 个 对 象 ， 所 以 你 就 会 对 fields 和 headers 感 兴趣 ，。 ee FATA 
左 侧 空白 的 提示 三 角 。 的 确 ，fields 变 量 是 一 个 NSArray ( 它 是 一 个 公共 的 抽象 类 是 一 个 实体 子 类 --NSArrayl) ， 其 
中 有 一 个 空 字 符 串 。 _headers 是 指向 headers 属 性 的 实例 ， 它 是 包含 12 个 元 素 的 数组 。 





那么 我 们 想 知 道 的 是 ， 什 么 将 导致 一 行 显示 为 空 元 素 ” 如 果 一 行 的 结尾 是 一 个 新 行 符号 ， 那 么 被 新 行 符 分 隔 的 “最 后 ”一 行 
束 会 是 空 行 。 将 self 中 的 内 容 在 变量 中 显示 出 来 ， 确 认 这 一 点 : lineCount 中 的 数字 与 sample-data.csv 中 的 行 数 应 该 精确 匹 
Ac. 


Ose 之 前 我 _ 直 都 在 猜测 ， 而 没有 测试 ， 我 错 了 。 
一 种 解决 方案 就 是 在 给 values 周 信之 前 增加 一 个 检查 


// Blank line; go to the next one 
if fields.count <= 1 { continue } 


同时 ， 因 为 CSV 解 析 器 应 该 能 够 捕捉 到 一 些 错误 。 


if fields.count != headers.count { 
// There should be as many fields as headers 
return .LineFormat (path, lineCount, 
headers.count, fields.count) 
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E 9 -[UlApplication _handleDelegate... 


E 10 -[UlApplication _callinitializatio... 
LI 11 -[UIApplication _runWithMainS... 
[3 12 -[UlApplication workspaceDid... 


ala 13 31-[FBSSerialQueve perform... 
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图 15_CFRunLoopDoBlocks 

E 16 _CFRunLoopRun 
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C] 18 -[UlApplication _run] 

回 19 UlApplicationMain 
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alloc... 


Eq 21 main 
| 22 start 
> i Thread 2 a 
Queue: com.apple.libdispatch-mana... 
T = 
(A) 默认 情况 下 ， 帧 中 有 很 多 与 代码 无 关 的 信息 ， 所 以 Debug 导 航 器 会 将 无 用 的 信息 都 从 堆栈 中 排除 。 它 们 的 位 置 由 
虚线 占据 。 (4) 单 击 导 航 器 左下 角 的 按钮 就 示 出 全 部 帧 
这 里 ，.LineFormat 是 CSVError 类 型 的 枚 举 值 。CSVError 定 义 了 4 种 错误 类 型 ， 在 示例 代码 中 能 看 到 全 部 ， 不 过 这 里 只 能 简 


单 地 看 一 下 : 


enum CSVError { 
case LineFormat (String, Int, Int, Int) 
case EmptyFile (String) 
case NoSuchFile (String) 
case ClientError (String, Int, NSError) 


func code() -> Int { 
switch self { 
case .LineFormat: return -3 


// Representing the SimpleCSVFile-side error 
// conditions is easy; translating them into 
// NSErrors, a little more involved: 
var nsError: NSError { 

var userDict: [NSString:AnyObject] = [:] 


switch self { 
case let .NoSuchFile (fileName): 


case let .EmptyFile(fileName): 


case let .LineFormat(fileName, lineNumber, expected, actual): 
userDict = [ 

NSFilePathErrorKkey : fileName, 
NSLocalizedDescriptionKkey 

"File \(fileName):\(lineNumber) has " + 

"\ (actual) items, should have \(expected)", 
CSVErrorKeys.ExpectedFields.toRaw() : expected, 
CSVErrorKeys .ActualFields.toRaw () : actual 


] 


case let .ClientError(fileName, lineNumber, error): 


} 


return NSError(domain: WT9TErrorDomain, 
code: code(), 
userinfo: userDict) 


10.5.2 ”运行 Passer Rating 


现在 我 保证 已 经 修复 了 所 有 | 问题 。 局 动 iOS 模 拟 器 ， 经 过 几 秒 的 延迟 ， 就 可 以 第 一 次 看 到 正常 运行 的 Passer Rating, WE 
10.4。 需 要 注意 控制 器 方面 的 问题 ， 但 是 数据 模型 看 起 来 与 预期 的 结果 保持 一 致 。 当 你 在 表 中 滑动 一 行 或 者 单 击 Edit 按 钮 时 ， 应 
用 程序 就 会 显示 删除 一 个 passer 的 操作 。 当 按 下 delete 键 ， 这 个 passer 就 会 从 表 中 移 除 。+ 按 钮 会 创建 一 个 名 为 
FirstNameLastName 的 passer， 这 也 能 满足 你 的 需求 。 到 现在 ， 这 个 App 运 行 很 正常 (直到 你 单 击 其 中 一 个 passer 条 目 ， 当 
App 无 法 在 Passer 中 找到 timestamp 属 性 的 时 候 ， 这 个 App 残 会 月 省) 。 


Ose 从 正在 运行 的 应 用 程序 中 删除 passet 数 据 有 点 危险 ， 因 为 你 只 能 执行 指定 的 次 数 ， 这 个 数据 集 最 多 只 能 删除 43 次 。 
不 过 ， 不 用 担心 数据 被 删 完 ， 因 为 应 用 程序 每 次 启动 ，AppDelegate 都 会 从 示例 数据 集中 重新 载 入 数据 。 


操作 完毕 之 后 ， 单 击 模拟 器 下 方 的 Home 按 钮 (如果 应 用 程序 的 界面 无 法 适 配 模 拟 器 一 对 一 的 尺寸 ， 那 么 也 可 以 选择 
Hardware>Home, tH) 回 到 Xcode 中 。 等 一 下 : Workspace 窗 口 工具 栏 中 的 Stop 按 钮 仍然 处 于 激活 状态 。 这 是 怎么 回 
事 ? 


记 住 ， 当 单 击 home 按 钮 的 时 候 ，iOs 程 序 并 没有 停止 运行 ， 而 是 在 后 侣 休眠 ， 你 可 以 在 任何 时 候 唤 醒 程 序 继续 执行 。 因 为 


Passer Rating 没 有 退出 ， 所 以 Stop 按 钮 仍然 可 以 用 ， 调 试 器 依旧 在 运行 。 轻 击 主屏 幕 中 应 用 程序 的 图 标 ， 束 会 重新 回 到 应 用 程 
序 继续 运行 。 


iO0S 这 种 处 理 机 制 很 正确 ， 但 它 可 能 不 是 你 想 要 的 效果 。 如 果 你 想 要 应 用 程序 停止 运行 ， 单 击 Stop 按 钮 ; 或 者 继续 下 面 的 工 
作 ， 当 想 要 运行 应 用 程序 的 时 候 ， 执 行 Run 命 令 。Xcode 会 显示 一 个 界面 ， 提 示 你 停止 正在 运行 的 应 用 程序 。 


iOS Simulator = iPhone 45s = iPhone 5s / iOS &.... 
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图 10.4 最终， 我 们 得 到 了 第 一 个 可 以 正常 运行 的 Passet Rating 应 用 程序 。 它 读 取 了 示例 数据 ， 列 出 了 passet 及 对 应 的 评分 ， 还 能 


执行 添加 和 删除 passet 的 操作 。 评 分 的 格式 可 以 在 以 后 清除 


Ox 提示 界面 中 会 提供 一 个 选项 : 之 后 遇 到 相同 的 情况 保持 一 样 的 操作 。 不 要 选择 这 个 选项 ! 假设 你 正 处 于 一 个 耗 时 
很 长 的 调试 会 话 ， 处 于 其 中 的 一 个 断 点 处 ， 可 能 你 还 想 要 继续 运行 。 当 前 你 正在 全 神 贯 注 地 工作 ， 注 意 力 没有 放 在 工具 上 。 你 要 
使 用 哪个 按钮 ? 窗口 中 间 靠 下 的 小 小 的 Continue 按 钮 ?9 还 是 左上 方 大 而 友好 的 Run 按 钮 9 如 果 没 有 适时 弹出 警告 面板 ， 那 么 哪个 


按钮 将 会 挫 毁 你 的 调试 历史 ? 


10.6 “人 小结 


在 本 章 中 ， 我 在 一 个 真实 的 iPhone 应 用 程序 中 验证 了 这 个 模型 。 人 在 这 个 过 程 中 ， 我 向 你 展示 了 如 何 更 改 类 和 文件 名 ， 如 何 
从 Xcode 模板 提供 的 简单 功能 更 改 为 包含 大 量 信息 的 实用 类 。 


我 们 见 到 了 Fix-it， 它 能 自动 修复 语法 错误 和 警告 ;Live lssues， 它 可 以 在 你 输入 的 过 程 中 实时 显示 错误 和 警告 。 这 些 由 小 
巧 的 llvm 库 提供 的 功能 组 合 ， 虽 然 无 法 完全 做 到 将 “检查 编译 ”从 你 的 工作 流程 中 去 除 ， 但 是 你 会 友 现 这 种 实时 的 支持 功能 会 让 
你 的 工作 流程 更 顺畅 。 


Passer Rating CSV 解 析 器 中 的 一 个 bug 让 你 有 机 会 深入 了 解 Debug 导 航 器 ， 学 习 如 何 通 过 一 些 数据 挖掘 工作 让 调试 更 简 
单 。 同 时 ， 使 用 调试 器 控制 台 ， 也 让 你 对 应 用 程序 的 运行 过 程 更 加 了 解 。 


第 11 草 ”构建 新 视图 


现在 ， 传 球 手 列表 功能 基本 完成 。 很 朴素 的 界面 ， 但 是 与 图 8.2 中 的 示意 图 非常 相似 ， 唯 一 缺少 的 就 是 从 传 球 手 列表 界面 切 
换 到 指定 传 球 手 详细 界面 和 比赛 列表 之 间 的 过 渡 动 画 。 想 要 完成 这 个 功能 ， 你 需要 创建 一 个 新 的 视图 控制 器 ， 还 要 了 解 
Interface Builder 的 使 用 。 


11.1 下 一 个 视图 控制 器 


有 一 点 需要 记 住 的 是 ， 除 非 你 要 做 自 定义 的 绘制 或 者 事件 处 理工 作 ， 否 则 几乎 没有 理由 需要 创建 一 个 新 的 UIView 子 类 。 标 
准 视 图 非常 通用 ， 易 于 组 合 ， 所 以 很 少 有 创建 新 视图 的 需求 。 设 置 视图 内 容 和 对 它们 捕获 的 事件 做 出 反应 这 样 的 需求 很 常见 。 你 
也 已 经 了 解 ， 这 就 是 MVC 设 计 模 式 中 控制 器 层 的 业务 ， 所 以 你 需要 一 个 子 类 UlViewController。 


11.1.1 如 果 想 要 添加 新 视图 控制 器 


现在 ， 不 需要 添加 一 个 视图 控制 器 。Master-detail 项 目 模板 提供 了 细 世 视图 ， 你 要 做 的 融 是 一 学 重信 名 和 逆 数 重 写 工作 。 
创建 一 个 新 的 视图 控制 器 ， 你 需要 做 些 什 么 ? 


这 并 不 难 ， 前 先 你 需要 .swift 源 代码 文件 作为 UIViewController 的 子 类 。 选 择 
File>New—Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (¢8N) ， 然 后 选择 iOS 一 Cocoa Touch 模 板 。 
你 需要 为 这 个 类 命名 ， 选 择 UIViewControllerf 为 父 类 ， 你 会 友 现 Xcode 将 ViewController 附 加 在 你 输入 的 类 名 后 面 ， 你 要 将 
这 个 名 字 改 回 你 想 要 的 名 字 。 选 择 Language 一 栏 中 选择 Swift， 这 就 是 一 个 视图 控制 器 ， 还 有 一 个 复 选 框 ，Also create XIB 


file， 之 后 我 将 会 讨论 它 。 


WEB Xcode 对 类 名 的 修改 操作 让 人 感到 很 厌烦 ， 但 是 它 遵 循 的 原则 非常 合理 : 选择 能 描述 这 个 文件 功能 的 词语 作为 名 


字 。 显 而 易 见 ，Xcode 起 的 这 个 名 字 做 到 了 这 一 点 ， 但 是 如 果 将 编辑 passers 的 控制 器 称 作 PasserEditor 或 者 PasserEditorView 更 好 一 


i 
O 


单 击 Next 按 钮 ， 然 后 使 用 之 前 见 到 的 文件 夹 选择 界面 ， 为 这 个 文件 在 硬盘 上 选择 一 个 存放 位 置 ， 再 选择 一 个 展示 这 些 文件 
的 项 目 组 ， 最 后 将 它们 赋 给 一 个 或 者 多 个 target。 


理论 上 你 可 以 这 样 做 。 探 制 器 的 创建 工作 基本 已 经 完成 。 实 现 .loadView 方 法 后 ， 这 个 控制 器 将 会 构建 整个 视图 树 。 


在 实际 工作 中 ， 很 少 会 这 样 做 ， 而 是 将 控制 器 视图 放 到 Interface Builder 文 档 创 建 的 布局 中 ， 通 常 是 storyboard， 这 样 就 可 
以 将 它 集 成 到 应 用 程序 的 设计 流 中 。 如 果 你 需要 一 个 独立 设计 一 一 比如 ， 想 要 在 不 同 的 环境 中 重复 使 用 相同 的 布局 一 一 那么 最 
好 将 这 个 视图 单独 放 在 属于 它 自 己 的 XIB 文 件 中 。 





这 也 就 是 为 什么 以 UIViewController 作 为 父 类 的 时 候 ，Also create XIB file 复 选 框 会 变 为 激活 状态 。 如 果 勾 选 这 个 选 
项 ，Xcode 就 会 创建 一 个 链接 到 新 类 的 XIB 文 件 。 


如 果 想 要 将 控制 器 添加 到 storyboard 工 作 流 中 ， 那 么 最 好 将 它 及 对 应 的 视图 作为 一 个 场景 添加 到 画布 中 。 在 Utility 区 域 的 
Object 库 中 找到 View Controller， 将 其 拖 入 画布 中 ， 它 会 自动 扩充 到 整个 屏幕 大 小 。 单 击 场景 上 方 的 工具 栏 ， 选 择 控 制 器 ， 然 
后 使 用 Identity inspect (第 三 个 选项 卡 ) 中 的 Custom Class 栏 将 新 类 标记 为 控制 器 。 


11.1.2 storyboard、scene 和 segue 


从 表面 上 看 ，Interface Builder 像 是 用 于 绘制 UI 布局 的 工具 ， 但 这 只 是 它 的 部 分 功能 : 更 准确 地 说 ，lnterface Builder 是 一 
个 编辑 应 用 程序 中 各 个 对 象 之 间 关 系 的 可 视 化 编辑 器 ，what-goes-where (什么 东西 放 到 哪里 ) 就 是 一 种 这 样 的 关系 。 


wits 从 20 世 纪 90 年 代 的 Xcode 35-48, Interface Buildet 就 是 一 个 独立 的 应 用 程序 。Xcode 中 的 其 他 编辑 器 也 与 主 代 码 编 辑 
器 有 很 大 不 同 ， 但 是 因为 它 长 时 间作 为 一 个 独立 应 用 程序 的 历史 ， 人 们 仍然 将 IB 视 为 一 个 独立 的 编辑 器 。 


之 前 你 已 经 在 其 他 平台 上 见 过 了 UI 布局 编辑 器 ， 大 多 数 编辑 器 都 会 提供 一 些 可 执行 代码 用 于 构建 视图 层级 关系 ; 或 者 它们 
作用 于 构建 过 程 中 转化 为 可 执行 代码 的 文件 ; 或 者 至 少 也 会 构建 用 于 创建 UI 对 象 的 数据 流 。1B 基 本 类 似 ， 它 也 会 操作 一 些 文件 ， 
这 些 文 件 会 在 目标 应 用 程序 构建 阶段 的 编译 和 安 委 中 使 用 。 


相似 的 地 方 就 这 些 。 记 住 : 没有 代码 ， 也 没有 脚本 。lnterface Builder 的 产品 不 可 执行 ， 它 们 是 Cocoa 对 象 的 文件 归档 。 这 
些 文 件 归档 包含 对 象 与 方法 之 间 所 有 内 部 及 外 部 的 链接 。 很 多 用 惯 了 其 他 平台 的 新 手足 想 要 看 到 代码 ， 仿 佛 只 有 这 样 才能 
解 “它们 到 搬 是 如 何 工 作 的 ”。IB 的 产品 残 是 它 真 正 的 要 实现 的 产品 。 除 去 一 泽 琐碎 的 情况 ，1B 很 难 生成 模拟 NIB 正 弟 载 入 过 程 
的 代码 ， 有 些 情况 下 (尤其 是 在 OS X 系 统 中 ) ， 这 根本 就 不 可 能 。 


局 注意 这 应 该 可 以 激发 你 的 思考 。 在 iOS 中 ， 动 态 初始 化 、 安 排 和 链接 视图 非常 有 用 一 有 很 多 项 目 模板 可 以 作为 应 用 
程序 的 起 点 但 是 代码 并 非 最 先 党 试 的 技术 。Interface Buildet 有 些 吓 人 ， 因 为 它 的 确 很 神奇 。 就 如 Cocoa 中 大 部 分 内 容 来 说 ， 
它 会 做 一 些 可 能 你 会 用 于 控制 自己 的 事情 。 放 松 点 ， 最 终 ， 如 果 你 能 熟练 使 用 Intetface Builder， 将 会 节省 大 量 与 操作 系统 做 斗争 
的 时 间 。 





storyboard 能 做 的 工作 更 多 : 它 提供 用 于 保存 场景 的 画布 ， 每 个 画布 代表 在 同一 时 刻 运 行 整个 界面 的 控制 器 ;各 个 控制 器 
之 间 用 segue 连 接 ， 从 一 个 场景 切换 到 另外 一 个 场景 。 在 运行 中 的 应 用 程序 中 轻 击 一 下 按钮 整 会 触 友 一 个 segue， 这 个 轻 击 事件 
会 直接 到 达 UIKit，UIKit 会 创建 下 一 个 场景 和 控制 器 ， 让 外 面 的 控制 器 有 机 会 接触 到 新 场景 的 配置 数据 ， 然 后 将 新 场景 移动 到 屏 
幕 中 。 再 次 强调 : storyboard 做 了 很 多 事 ， 你 可 能 需要 适应 。 如 果 你 能 让 目 己 的 思维 融入 这 个 工作 流 的 优点 之 中 ， 你 会 友 现 目 
己 几 乎 能 更 有 效率 、 更 容易 地 做 任何 事情 。 


安排 工具 


Interface Builder 对 编辑 空间 有 特殊 的 要 求 。 一 个 完整 的 storyboard 非 常 大 ， 你 可 以 使 用 Editor 一 Canvas 一 Zoom 子 菜单 放 
大 或 者 缩小 ， 或 者 使 用 触 控 板 上 面 的 缩小 手势 ， 但 是 即便 只 是 制作 应 用 程序 的 单个 界面 ， 画 布 视 图 上 面 的 每 个 像素 都 相当 精确 。 
Mac 屏 幕 可 能 无 法 一 次 性 显示 iPad 的 全 部 布局 。 


wits 当 最 大 化 的 时 候 ， 画 布 会 布 满 整 个 屏幕 ， 这 也 是 Ihtetface Buildet 允 许 视 图 布局 的 最 大 尺寸 。 不 过 ， 你 可 以 在 缩小 


的 视图 上 添加 场景 ， 连 接 outlets、actions 以 及 segues。 


1B 的 左 侧 边 缘 是 一 个 文本 大 纲 视 图 ， 基 本 上 你 不 会 关闭 这 个 视图 。1B 的 右 侧 是 工具 区 域 ， 用 于 创建 视图 和 调整 已 经 插入 的 视 
图 。 如 果 你 使 用 Assistant editor (有 的 时 候 必 须要 用 到 ) ， 这 些 工 具 之 间 的 联系 就 会 更 加 紧密 。 你 不 需要 的 区 域 是 Navigator 
区 ， 因 为 你 会 将 大 部 分 时 间 都 花费 在 1B 文档 或 者 调试 区 域 上 。 


选项 卡 能 完成 区 域 显示 的 切换 。 你 很 可 能 已 经 将 工作 空间 窗口 设置 为 适宜 编辑 源 代 码 的 配置 。 选 择 File 一 New 一 Tab (dt 
T) 。 你 会 在 这 个 选项 卡 下 做 所 有 关于 IB 的 工作 ， 所 以 双击 选项 卡 名 ， 将 它 改 为 Interface Builder, 


现在 配置 这 个 选项 卡 : 在 Project 导 航 器 中 选中 Main.storyboard。 使 用 工具 栏 中 的 View 控 件 (部 分 高 亮 的 3 个 矩形 ) ， 关 闭 
Navigator 和 Debug 区 域 ， 然 后 打开 Utility 区 域 。Utility 区 域 的 底部 称 为 Library， 选 中 Object 库 选 项 卡 (第 三 个 带 有 方块 图 形 的 
选项 卡 ) 可 以 将 能 放 进 画布 或 者 场景 的 对 象 显示 出 来 。 


不 显示 Project 导 舰 器 的 时 候 ， 如 何 访问 其 他 文件 呢 ? 在 本 项 目 中 ， 这 并 不 是 一 个 问题 : Passer Rating 仅 有 一 个 
storyboard， 从 始 至 终 也 仪 需 这 一 个 storyboard。 但 是 之 后 的 项 目 可 能 会 需要 企 Interface Builder 中 党 理 多 个 文件 。 如 何在 这 


些 storyboard 中 切换 而 不 用 将 Navigator 区 域 重新 显示 出 来 ? 


可 能 你 已 经 注意 到 Editor 区 域 上 面 有 一 栏 ， 称 为 跳 转 栏 (jump bar) ， 这 上 面 有 一 系列 的 控件 能 直接 浏览 项 目 文件 。 此 时 
最 让 你 感 兴趣 的 是 路 径 控 件 ， 它 占据 了 跳 转 栏 的 大 部 分 空间 。 跳 转 栏 中 的 路 径 被 划分 为 一 段 段 租 头 形状 的 控件 ， 每 一 段 都 是 文件 
路 径 的 一 部 分 ， 从 项 目 根 目录 一 直到 每 个 文件 (在 结构 化 的 文档 中 ， 这 个 路 径 穿越 了 锐 数 或 者 1B 对 象 的 层次 结构 ) 。 如 果 当 前 文 


件 存在 可 以 选择 的 文件 ， 最 后 一 个 链接 束 会 显示 出 可 以 选择 文件 的 文件 名 ， 见 图 11.1。 


Ny Passer Rating » Wh iPhone 5s Passer Rating | Build Passer Rating: Succeeded | 


Main.storyboard Main.storyboare 


a | 4 5 Passer Rating > Passer Rating 》 = Main.storyboard = Main.storyboard (Base) Detail Scene » O Detail 





> 加 Navigation Controller $... 


P „iy Passer Rating » ES iPhone 5s Passer Rating | Build Passer Rating: Succeeded | 


回 PRPlayground.playground Main.storyboare 


Ej Passer Rati | Passer Rating x > | mogenerated 


Passer Ratinglests | » AppDelegate.swiit 
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c| Navigation Controller $. 
> (=) Master Scene | a GameListController.swift 


¥ E] Detail Scene 


y Oo Detail 
|| Top Layout Guide 
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p View 
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supporting Files 
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当前 文件 及 其 中 可 以 选择 的 文件 。 (下 ) 路 径 控件 中 的 每 一 级 都 是 一 个 层次 化 的 弹出 菜单 ， 它 能 让 你 设置 路 径 


单 击 路 径 中 的 一 段 就 会 弹出 一 个 菜单 ， 其 中 提供 了 对 应 层级 中 的 项 目 、 组 、 文 件 ， 以 及 可 选择 的 内 容 。 弹 出 菜单 本 身 也 是 分 
层次 的 ， 所 以 你 可 以 在 编辑 其 中 记录 一 个 新 路 径 。 如 果 跳 转 栏 中 的 一 层 包 含 大 多 项 目 ， 无 法 用 肉眼 检索 ， 那 么 就 可 以 通过 输入 字 
符 串 的 方式 缩小 显示 范围 。 搜 索 关 键 字 并 不 连续 ， 所 以 输入 alcon 就 会 显示 出 PasserListController 和 GameListController 这 两 个 
Swift 文件 。 


这 惑 促 成 了 一 种 策略 : 如 果 你 有 多 个 XIB 和 storyboard 文 件 ， 那 么 就 可 以 在 专门 的 Interface Builder 选 项 卡 中 工作 。 再 次 打 
开 Project 导 航 器 ， 在 底部 的 搜索 栏 中 输入 .xib 检 索 出 项 目 中 的 XIB 文 件 。 


使 用 Command-click 的 方式 选中 所 有 的 XIB 文 件 ， 然 后 选择 File 一 New 一 Group from Selection。 现 在 所 有 的 XIB 都 在 一 个 
组 中 ， 也 就 是 说 在 跳 转 栏 的 同一 级 中 ， 你 可 以 将 storyboard 文 件 放 到 相同 的 组 中 ， 路 径 控件 中 的 文件 段 能 让 你 在 设计 文件 中 直 
接 切 换 。 为 了 更 好 地 显示 效果 ， 你 也 可 以 关闭 Project 导 航 器 。 现 在 工作 控件 应 该 看 起 来 如 图 11.2 所 示 。 
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Interface Builder Passer Rating.xcodeproj 


< © Passer Rating Passer Rating Ẹ Main.storyboard zi Main.atcryboard (Base) > No Selection 


+ E Navigation Controller S... 

v E Passers Scene Passers 
y Passers 

b Table View 


Passers 
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[E Exit 
Show segue to Detal Title 
7 Detail Scene 
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Top Layout Guide 
— | Bottom Layout Guide 
P View 
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View Controller - A controller that 
supports the fundamental view- 
management model in IOS. 


Navigation Controller - A controller 
that manages navigation through a 
nierarcny of views 


Table View Controller - A controller 
that manages a table view. 


Tab Bar Controller - A controller that 
manages a set of view controllers that 
represen! tab bar ilus. 
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图 11.2 ”如果 你 为 Interface Buildet 创 建 了 一 个 自己 的 选项 卡 ， 按 照 需求 配置 ， 你 会 发 现 它 很 容易 使 用 


11.2 ”创建 视图 


Master-Detail 应 用 程序 模板 提供 了 一 个 细节 控制 器 类 (我 们 已 经 将 它 重 命名 为 GameListController) ， 并 且 意 识 到 它 在 
Main.storyboard 中 作为 画布 的 第 三 个 场景 ( 见 图 11.3) 。 第 一 个 场景 市 有 一 个 稍 头 ， 显 示 出 它 是 storyboard 中 的 初始 场 


景 ，UINavigationController 用 于 管理 这 个 场景 。 它 通过 一 个 root view controller segue 连 接 到 初始 化 的 内 容 


中 ，PasserListController 表 示 passer 的 伦 名 册 。 同 样 ， 一 个 push segue 链 接 到 了 下 一 步 ， 比 赛 询 表 。 


havigation Conroller 





图 11.3 ”master-detail 项 目 模 板 文件 使 用 3 个 场景 填充 Main.storyboard: 包含 主场 景 (Passef List Controller) 的 导航 控制 器 ， 它 级 联 到 


细节 视图 (Game List Controller) 


导航 控制 器 是 其 他 两 个 控制 器 的 包装 器 ; 它 管 理 了 屏幕 中 进 进 出 出 的 视图 ， 用 户 使 用 它 在 层级 结构 中 导航 ， 比 如 从 passer 列 
表 到 达 passer 的 细节 记录 。 在 屏幕 的 顶部 也 有 一 个 导航 栏 ， 用 来 显示 当前 视图 的 标题 ， 还 有 一 个 用 来 回 退 到 上 一 级 的 按钮 (从 
passer 到 passer 列 表 ) 。 第 一 个 场景 链接 到 了 root view， 它 是 控制 器 首先 要 展示 的 视图 。 


控制 器 栈 中 的 视图 都 会 显示 导 舰 栏 ， 但 是 那些 控制 器 并 不 实际 管理 导航 栏 : 导航 栏 束 在 那里 ， 所 以 在 布局 的 时 候 需 要 考虑 空 
间 安 排 。 


工作 链 的 最 后 一 个 视图 是 “细节 ”视图 ， 我 们 已 经 
包含 一 个 标签 。 这 个 模板 简单 地 用 Event 实 体 保存 的 时 间 填 充 这 个 标签 。i 


些 问 题 需要 注意 。 





模板 使 用 Mastetr 和 Detail 作 为 标题 ， 这 已 经 开 


置 为 Passefs 和 Games , 


11.2.1 Passing 中 的 Outlet 和 和 Assistant 


单 击 工具 栏 Editor 分 组 中 间 的 那个 选 
域 中 ; 氏 加 Assistant editor, 


ie Posner Rating ) B Prone sa 


interiaca Bulle ar 


Be x $ Passer Rating ) (0) Pasa. ..ating ; B Main.. oard |-| Wain.. eac 


= l WP E 
b |e) Navigation Certraller &... 
y | Passors Scone 
7 i Pma Gamas 
| Tatin ‘wheres 
¢ |Para 
= 
(fl First Responder 
[H Exit 
Beir bagia be Gamea 
T 轩 Games Scene 
7 (OD) Garos 
Top Layout Gada 
L| Bottom Layout Guide 
t |_|] vien 
«| Games 
fl First Responder 


国 Exit 


Detail view content goes here 


图 11.4 单 击 Editor 分 组 中 间 的 按钮 (图 标 看 起 来 就 像 背 


实际 上 ，Assistant editor 只 是 另外 一 个 编辑 器 ， 


+ BB Detail Scene} E 


它 能 让 你 在 工作 的 时 候 查 看 多 个 文件 。 


将 它 重 命名 为 GameListController， 


选中 每 个 场景 ， 铝 


器 (Utility 区 域 的 第 四 个 选项 卡 ) o 


， 在 每 个 场景 中 选中 导航 栏 ， 也 设置 对 应 的 标题 。 


Passar Aaima | Buld Passor Railing: Gueneaded | Today a h4T PH 


Paser Paling. 2coceapre| 


Games }|_|View | fe ¢ Th durtomatic 


Fy 
if GameListContral ler. swift 
' Passer Rating 


Created Ey Fritz Andersen o i 
pyridyl iui 2014 F le Aredersuns A ri 
Pe. ered. 
ff 


import UIKit 
class GameListContraller: UlViewController { 


GIBOutLet var detai WDWegeriptlonLabel: UILabe l! 


var detailltem: Anydbject? { 
didset { 
jj Ae ite the view: 
self. conf igureviewt | 
} 
} 


func contigurev¥iew!) { 
ff Update the user interface 
Ltem. 
if let detail: AnyObject = self.detailltem 


if let Label. = gelf. 
detai DWescrietlonLabe l q 
label.text = 
detail.valuePorkKey("timeStanp™) 
-description 


e func viewDidLoad{} 
super. ¥ilewDidLoad { | 
fr Do any additional setup afte 
the view, typically T i a 
5e Lf. configu review! | 


} 
override func didheceiveMenoryWarning!) 二 
心 和 领结 ) 添加 Assistant editor, 


， 如 图 11.4 所 示 。 


i GameletControllenswift > He Seeon 全 x 


for the detail 


这 个 视图 来 目 空 视图 的 模板 ， 其 中 
这 并 不 是 你 想 要 的 效果 ， 但 是 在 我 们 更 改 之 前 ,还 


= ”所 有 的 UIViewControllers 都 有 一 个 title 属 性 ， UINavigationConttollet 使 用 这 个 属性 填充 导航 栏 的 标题 。Mastet-Detail 
ARAA HET RK. 
在 顶部 的 导航 栏 显示 3 个 图 标 。 单 击 它 ， 然 后 选中 Attributes 查 看 


后 将 画布 缩放 到 百分之百 显示 ， 活 动 的 场景 将 会 


将 View Controller-Title 分 别 设 


先 项 ， 图 标 看 起 来 束 像 是 一 个 正六 背心 和 领结 (代表 管家 制服 的 意思 ) ， 残 会 企 Editor 区 
它 可 能 会 破坏 你 圣 藻 构建 的 窗口 布局 ， 所 以 稍微 做 些 调 整 
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Tag 
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Tint | Default 
Drawing Ed Cpagque Hidden 
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dorgmrs Sl vere 
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然后 需要 对 项 目 布局 做 些 调整 


这 是 它 的 一 种 使 用 方式 。Assistant 


editor 特 殊 的 地 方 在 于 它 能 目 动 选择 内 容 ， 反 了 映 出 你 在 主编 辑 器 中 所 做 的 操作 。Assistant editor 中 的 跳 转 栏 决定 了 它 依赖 的 天 


系 。 使 用 路 径 个 菜单 ， 将 assistant 设 置 为 Automatic， 然 后 在 |B 画 布 上 单 击 不 同 的 对 象 ， 就 会 发 现 Assistant 
将 对 象 后 面 的 源 代码 显示 出 来 。 





editors 


单 击 Game Controller 场 景 上 方 日 色 的 工具 栏 ，Assistant editor aft 
文件 ， 那 么 跳 转 栏 的 右 侧 末 端 束 会 显示 匹配 的 文件 个 数 ， 同 时 通 


会 显示 GameList Controller.swift。 如 果 有 多 个 匹配 
过 单 击 答 头 的 两 闹 可 以 在 文件 之 间 切 换 。 


模板 会 将 这 一 行 添加 a 到 类 的 声明 中 : 


@TBOutlet var detailDescriptionLabel: UILabel! 


所 以 。 挥 制 器 的 属性 之 一 丈 是 视图 中 间 标 签 的 引用 。 还 有 更 多 的 地 方 值得 注意 : @IBOutlet 属 性 。 它 只 不 过 是 Interface 


Builder 的 一 个 信号 ， 意 味 着 视图 控制 器 中 的 这 个 属性 可 以 接受 场景 中 指向 某 个 对 象 的 指针 。 


StS ”UILabel 类 型 上 有 一 个 感叹 号 ， 在 第 10 章 中 已 经 看 到 过 。 它 虽然 保证 了 初始 值 是 nil， 但 是 Swift 在 使 用 它 之 前 可 以 假 


设 它 是 非 nil 的 。 


当 你 首次 查看 这 是 什么 意思 的 时 候 ， 将 鼠标 移动 到 这 一 行 旁边 的 圆 点 上 ， 见 图 11.2。 这 个 圆 点 融会 显示 出 一 个 从 1B 对 象 与 


outlet 之 间 的 链接 。 当 鼠标 移 过 链接 点 时 ，lnterface Builder 会 通过 在 画布 中 高 之 显示 这 个 标签 来 表示 这 个 链接 。 


class GameListController: UIViewController { 


Detail view content goes here 


3 BIBOutlet var detailDescriptionLabel: UI 





图 11.5 IJIBObject 属 性 可 以 用 指向 对 象 的 指针 赋值 ， 当 场景 载 入 的 时 候 ， 这 些 对 象 就 会 实现 。 将 鼠标 从 一 个 outlet@ptoperty 指 令 


FETTE LRT, MAH che BAR PT MTR 


这 就 是 本 次 能 看 到 的 内 容 ， 之 后 还 会 介绍 更 多 内 容 。 现 在 ， 我 们 不 表 需 要 这 个 标签 。 在 game-controller 场 景 中 选中 它 ， 按 
下 delete 键 。 注 意 @property 指 令 旁 边 的 链接 气泡 现在 已 经 空 了 ， 选 中 这 条 线 删除 它 。 现 在 ， 已 经 没有 outlet 属 性 的 定义 。 每 次 
想 要 在 configureView(0 中 引用 它 的 时 候 ，Xcode 中 就 会 提示 一 个 错误 ， 所 以 也 要 删 掉 对 应 的 代码 。 


Ozi 如果 你 想 要 使 用 另 一 种 方法 ， 忘 记 了 删除 这 个 标签 ， 将 会 导致 月 溃 : 当场 景 载 入 的 时 候 ，storyboatd 仍 然 想 要 使 用 
这 个 标签 。UIKit 就 会 在 控制 器 中 查找 outlet 属 性 ， 当 无 法 找到 的 时 候 就 会 抛 出 异常 。 错 误 信 息 很 模糊 ， 看 不 出 什么 端倪 ， 你 不 得 
不 自己 找到 未 删除 的 引用 。 请 确保 删除 对 象 的 时 候 也 删除 对 它 的 引用 。 


11.2.2 Billboard Æ] 


现在 你 可 以 添加 自己 的 内 容 。 这 个 设计 需要 两 个 元 素 : 一 个 billboard， 包 含 passer 的 全 部 统计 数据 ;还 包括 一 个 带 有 每 场 
比赛 详细 信息 的 表 。 现 在 开始 制作 billboard。 


billboard 中 标签 的 大 小 、 风 格 各 异 。 首 先 ， 添 加 容器 本 身 。 单 击 底部 Object 库 中 的 搜索 栏 (第 三 个 选项 卡 ，Utility area F 
A) ， 然 后 输入 UlView。 你 束 会 看 到 一 个 标记 为 View 的 选项 ， 把 它 从 对 象 库 中 拖 到 编辑 器 场景 中 。 当 执行 拖 搜 操作 的 时 候 ， 它 
束 会 变 成 一 个 目 动 适 配 场景 的 正 万 形 ， 先 这 样 。 


你 并 不 想 让 这 个 视图 占据 整个 空间 。 单 击 这 个 视图 就 会 看 到 视图 的 边缘 和 角落 显示 出 可 以 调节 大 小 的 “把 手 ”。 给 出 新 视图 
的 大 小 ， 这 可 能 对 你 的 帮助 不 大 一 一 白费 力气 ， 没 有 办 法 确定 你 现在 处 理 的 是 哪个 边 角 。 选 择 Editor 一 Canvas 一 Show Bounds 
Rectangles， 显 示 出 视图 的 边 ， 这 样 会 更 好 一 点 。 


将 底 边 往 上 拖 直 到 视图 占据 屏幕 1/4 可 用 空间 (168points) 。 这 样 做 可 能 有 点 投机 取 巧 ，1B 会 自动 将 边缘 对 齐 到 父 视图 。 
拖 动 上 面 的 把 手 可 能 会 更 简单 些 ， 将 其 向 下 拖 动 ， 然 后 将 更 改 大 小 后 的 视图 向 上 移动 ， 直 到 它 靠近 导航 栏 。 


为 了 与 导航 栏 相 匹配 ， 细 节 视 图 应 当 设 置 为 浅 灰 色 。 在 Attribute inspector 中 ， 有 一 个 Background 控 件 ， 它 由 两 部 分 组 
成 : 左 半边 是 颜色 选择 器 ， 单 击 可 以 打开 编辑 关 色 的 调 色 板 ; 右 侧 是 一 个 包含 标准 颜色 的 下 拉 有 菜单 。 单 击 颜色 选择 器 ， 打 开颜 色 
选取 器 面板 ， 单 击 放大 镜 按钮 ， 再 单 击 场景 中 已 经 存在 的 导航 栏 。 查 看 器 如 图 11.6 所 示 。 
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图 11.6 ” 当 你 完成 操作 的 时 候 ，passer billboard 视 图 中 的 Attributes inspectof 看 起 来 应 该 像 这 样 


相当 漂亮 ， 对 不 对 ? 使 用 Assistant editor 中 跳 转 栏 的 第 一 段 ， 展 示 布 局 的 Preview (如 果 还 没有 选中 ， 那 么 选择 
GameListController 场 景 ) 。 你 会 看 到 如 图 11.7 所 示 的 内 容 ， 场 景 会 被 演 染 成 屏幕 中 显示 的 样子 。 


Preview 视 图 的 左下 角 包 含 一 个 + 按钮 ， 可 以 添加 设备 布局 ， 比 如 不 同 的 iPhones 和 iPads 尺 寸 。 每 个 预览 图 的 格式 (比如 
iPhone 4-inch) 下 方 都 有 一 个 白色 的 工具 栏 ， 它 提供 了 旋转 视图 的 按钮 。 你 可 以 一 次 性 选择 多 个 : 第 二 次 添加 一 个 布局 ， 它 就 
会 显示 与 存在 的 场景 不 同 的 朝向 ， 它 允许 你 在 两 个 朝向 上 同时 监控 布局 状态 。 


还 有 一 系列 的 修改 要 做 。 首 先 ， 让 billboard 对 GameListController 可 见 ， 然 后 稍微 了 解 下 Auto Layout (自动 布局 ) 。 


ryboard > 加 Main.storyboard (Base) > Games Scene > {0} Games 加 | View > Ol View za | < > | Gh Preview } Main.storybaard (Preview) | 日 | + x 





iPhone 4-inch 


wAny hAny IS tod td ET] + English 





图 11.7 Assistant editot 的 跳 转 栏 中 选中 Preview 视 图 ， 就 能 直接 显示 已 选中 场景 的 泻 染 图。 左下 角 的 控件 会 根据 屏幕 大 小 、 朝 
向 等 条 件 更 改 视图 的 表现 形式 


11.2.3 ”链接 钢 图 与 钢 图 控制 器 


视图 控制 器 可 以 将 数据 与 视图 联系 在 一 起 。GameListController 需 要 直接 访问 它 的 主 视图 (通过 view 属 性 ， 它 会 自动 链接 
到 storyboard 场 景 ) MEFE (必须 分 辩 和 链接 上 自身) 。 包 含 这 些 指针 的 实例 变量 都 用 @IBOutlet 属 性 标记 。@IBOutlet 
对 生成 的 代码 没有 任何 作用 ， 它 仅 仪 是 Interface Builder 的 一 个 信号 ， 这 个 属性 可 以 灵活 地 链接 到 storyboard 或 者 NIB 中 。 


在 storyboard 画 布 中 选中 比赛 询 表 场景 ; 确保 当 Assistant editor 打 开 的 时 候 可 见 。 在 assistant 跳 转 栏 中 选择 第 一 个 条 目 ， 
选择 Automatic 一 GameListController.swift。 测 试 : 单 击 另 外 一 个 场景 或 者 视图 ， 然 后 看 到 assistant 跟 踪 了 选择 的 对 象 ， 并 显 
示 了 对 应 控制 器 的 源 代 码 。 回 到 GameListController 场 景 。 


按 住 control 键 ， 然 后 将 billbpoard 视 图 拖 到 控制 器 的 class 代 码 中 。 有 具体 的 位 置 没有 关系 ， 只 要 它 不 在 enums 或 者 func 中 。 
代码 中 会 出 现 一 条 水 平 的 搬入 线 ， 它 的 意思 是 如 果 松 开 鼠 标 ， 代 码 惑 会 揪 在 这 里 ， 创 建 一 个 outlet 或 者 action 方 法 (后面 会 用 


到 ) ， 见 图 11.8。 


当 你 释放 鼠标 后 ，lnterface Builder 就 会 显示 一 个 弹出 对 话 框 ， 让 你 指定 想 要 创建 的 链接 类 型 以 及 名 称 。 将 其 称 为 
billboard， 并 单 击 Create 按 钮 。 
L fs 


:i Game@listControl ler. swift 
f/f Passer Rating 


rm y E m aal 


ff 
// Created by Fritz Anderson on 7/14/14. 

CG > Z/ Copyright (c) 2014 Fritz Anderson. ALL rights re 
i? 


5 import UIKAT 


11 class GameListController: UlViewController 414 





Pl 





Insert Outlet or Outlet Collection 


16 var detailltem: AnyObject? f 
j didset { 

18 // Update the view. 
19 celf.contigureview ) 


Fr GamelistController. swif' 
if Passer Rating 


4 ff 
A/ Created by Fritz Anderson on 7/14/14. 
ah b f/f Copyright {c} 2014 Fritz Anderson. ALL rights re 
i E As 9 : 
* import UIKit 
ar Connecton | Outlet w|i 
| Object (E Games | class GameListController: UlViewControLller ¢ 
Name | bnooard_ | 
Type | UIView D. 
: a 
Storage Weak i} var detailItem: AnyObject? { 
| didset { 
JPE | 
Hace Conn 3 /f Update the view. 
19 seLlf.cantigureview) 
20 } 
g 2l 


图 11.8 (E) 在 stofyboatd 场 景 中 Contfol-dfagging 一 个 视图 到 场景 控制 器 对 应 的 代码 中 ， 将 会 显示 一 个 outlet 插 入 栏 ， 用 于 插入 
outlet 或 者 action。 (F) 释放 和 鼠标 就 会 显示 一 个 弹出 菜单 ， 其 中 可 以 指定 链接 、 类 型 和 名 称 。 单 击 Connect 按 钮 就 能 为 视图 插入 一 
个 @IBOutlet 


现在 你 的 类 包 舍 一 行 新 代码 : 


@TBOutlet weak var billboard: UIView! 


它 表示 UIView 中 名 为 billboard 的 outlet。Weak 的 意思 是 指控 制 器 并 不 “拥有 ”这 个 视图 ， 同 时 如 果 每 个 其 他 拥有 者 (e 
如 视图 树 ) 撤销 这 个 视图 ， 那 么 billboard 就 会 变 为 nil。 之 前 我 们 没有 见 过 ! 一 这 个 变量 表示 “ 隐 式 打开 (implicitly 
unwrapped) ”， 也 就 是 说 你 要 保证 从 开始 使 用 它 起 ，billboard 就 要 指向 实际 的 对 象 ， 所 以 Swift 使 用 ! 将 你 从 每 次 都 要 解 引用 
中 解放 出 来 。 





还 有 一 点 : 如 果 展 开 文 档 大 纲 〈 单 击 画 布 左 下 角 的 按钮 ) ， 展 开 Game Scene， 你 会 发 现 UIView 包 含 一 个 UIView。 也 就 是 


说 根 视 图 来 源 于 包含 其 他 视图 的 场景 ， 也 就 是 billboard。 随 着 场景 越 来 越 复杂 ， 通 用 名 称 的 作用 越 来 越 小 。 


在 billboard 选 中 的 情况 下 ， 查 看 Identity inspector (lnspector 面 板 上 的 第 三 个 选项 卡 ) ， 然 后 在 Document 中 的 Label 栏 
中 输入 Billboard。 将 焦点 从 这 一 栏 中 移 除 ， 你 会 上 友 现 大 纲 中 ，billboard 显 示 的 是 这 个 名 字 。 


11.24 ”特定 场合 下 的 目 动 布局 


接 下 来 ， 我 们 介绍 Auto Layout ( 目 动 布局 ) 。 目 动 布局 是 一 项 确保 视图 总 是 能 按照 你 的 意愿 显示 在 合适 的 位 置 和 大 小 的 近 
术 ， 而 不 用 关心 屏幕 的 大 小 和 朝向 ， 这 个 视图 与 下 面 的 视图 有 8points 的 间距 ， 中 间 摆 放 等 。 正 确 表达 “意图 ”是 一 件 非常 困难 
的 事 ，Apple 尽 力 想 把 它 做 好 。 不 笠 的 是 ， 实 际 制 作 过 程 中 还 是 会 给 你 市 来 痛 否 。 


现在 ,我 们 至 少 要 能 让 billboard 正 确 显示 在 屏幕 中 (或 者 在 所 有 地 方 都 显示 正确 ; Auto Layout 设 置 的 这 些 值 会 在 横 屏 的 时 
候 导 致 billboard 的 高 度 为 0) 。 本 草 的 内 容 介绍 得 非常 快 、 非 常 杂 。 在 第 12 草 中 我 将 会 深入 介绍 。 


用 系统 性 的 约束 (constraints) 表达 你 的 意图 ，Cocoa 会 根据 这 些 约束 布局 视图 。 这 种 布局 方式 非常 灵活 ， 也 很 高 效 。 核 
心 的 原则 并 不 难 理解 : 每 个 视图 的 大 小 以 及 横 坚 坐标 的 位 置 都 应 该 完全 由 不 相 冲 突 的 约束 链 指定 。 就 这 么 简单 。 


理解 起 来 容易 ， 但 是 实施 起 来 元 有 些 困 难 。 我 不 满意 我 们 将 要 构建 的 天 于 billboard 视 图 的 约束 系统 ， 直 到 试 了 将 近 40 次 才 
满意 (这 还 是 在 Xcode 5 的 情况 下 ，Xcode 6 需要 更 多 操作 ) 。 有 些 冲 突 无 法 避免 ， 你 不 得 不 在 目 动 布 局 中 添加 一 些 优先 级 的 属 
性 ， 以 及 一 长 串 的 依赖 关系 ， 这 其 中 包含 大 量 珊 雁 的 工作 和 错误 。 本 章 大 部 分 时 间 都 伦 企 了 调整 billboard 视 图 位 置 的 正确 性 


本 章 剩 下 的 部 分 基本 都 是 天 于 构建 billboard 视 图 的 内 容 。 为 了 解决 bilboard 消 失 的 问题 ， 有 :5 件 事 你 必须 要 处 理 好 : 


1) 单 击 GameListController 场 景 上 面 的 控制 栏 ， 然 后 选择 Editor 一 Resolve Auto Layout lssues 一 Add Missing 
Constraints in Game List Controller。 这 个 操作 会 在 billboard 视 图 相对 于 距 它 最 近视 图 添加 最 佳 限制 |。 


2) 如 果 Preview assistant 中 仍然 显示 着 4 英寸 紧 版 的 屏幕 ， 你 会 看 到 billboard 被 垂直 压缩 了 一 些 ， 高 度 从 168 降 为 了 106。 
如 果 翻 转 预览 界面 ，billboard 视 图 的 高 度 没有 发 生 任何 变化 。 


3) 选中 billboard 视 图 ， 然 后 查看 Size inspector (第 五 个 选项 卡 ) : 面板 的 底部 是 |B 添加 到 视图 中 的 约束 条 件 列 表 。 水 平 
方向 上 的 leading 和 trailing ( 稍 后 我 会 介绍 这 两 个 术语 的 含义 ) 与 容器 之 间 的 间距 固定 ， 这 看 起 来 没有 问题 ， 你 想 让 视图 的 边界 
Sel RAR. 


上 下 边界 的 位 置 都 遵循 各 目的 布局 向 导 (layout guides) ， 屏 幕 视 图 中 的 虚线 表示 向 上 或 者 下 栏 靠 近 ( 导 舰 栏 、 选 项 卡 、 
状态 栏 、 工 具 栏 ) 压缩 可 使 用 的 垂直 空间 。 我 移动 billboard 的 位 置 并 调整 大 小 ， 上 边界 位 于 建议 的 位 置 ， 离 下 边界 的 距离 是 368 
points。 上 部 规则 人 允许 状态 栏 和 导航 栏 距离 屏幕 界面 上 方 134 points。 所 以 当 设 备 更 改 为 水 平 放置 时 ，billboard 的 实际 高 度 为 
320- (0+64) (工具 栏 的 高 度 ) -358 (底部 空白 ) =-112points。 “丢失 的 约束 ”并 没有 让 实际 情况 良好 。 


经 过 再 三 考虑 ， 我 们 天 心 的 仅仅 是 让 billboard 处 于 上 部 工具 栏 的 下 万-( 我 们 对 此 有 一 个 约束 ) ， 我 们 并 不 关心 它 是 否 能 与 
底部 距离 保持 恒定 (但 是 |B 却 给 出 了 这 个 约束 ) 。 我 们 需要 关心 的 是 它 有 一 个 恒定 的 高 度 (但 是 我 们 却 没有 对 应 的 约束 ) 。 


4) 选中 billboard view 本 身 。 在 视图 的 底部 和 视图 的 边界 之 间 束 会 出 现 一 条 线 ， 表 示 底 边界 约束 。 单 击 选中 (第 一 次 可 能 
会 无 法 选中 ， 如 果 没 选中 ， 重 新 选择 billboard 然 后 再 次 尝试 。 当 鼠标 从 这 条 线 上 划 过 的 时 候 ，1B 会 高 亮 显 示 它 ) ， 按 delete 键 
IRE. 


5) 在 编辑 器 的 右 下 角 ， 你 会 看 到 一 个 按钮 组 。 其 中 市 有 4 段 的 一 个 按钮 控制 着 目 动 布局 。 让 billboard 仍 然 处 于 选中 状态 ， 


单 击 Pin 按 钮 (上 oj ) ， 就 会 弹出 一 个 界面 ， 在 其 中 义 选 Height。 然 后 单 击 界面 底部 弹出 菜单 中 的 Add 1 Constraint. 


大 功 告 成 ， 现 在 ， 无 论 是 在 预览 界面 还 是 模拟 器 中 ，billboard 在 不 同 屏幕 尺寸 和 放置 方向 下 都 能 按照 我 们 的 期 望 显示 。 在 
完成 billboard 的 工作 之 前 ， 还 有 一 步 要 做 。 


11.2.5 ”各 种 标签 


billboard 视 图 中 包含 14 个 UIKit 中 的 UlLabel| 类 的 实例 ， 其 中 有 一 些 是 通俗 意义 上 的 标签 一 一 用 来 区 分 屏幕 上 不 同 对 象 的 充 
人 态 文 本 ， 其 余 的 都 是 动态 标签 。 因 为 应 用 程序 将 会 修改 它们 的 内 容 ， 但 是 user 却 不 会 。 这 些 标签 会 分 为 3 组 : 


. 顶部 的 名 称 标签 。 
` 左边 这 一 组 ， 包 含 诸如 total attempts 这 种 累计 统计 数据 的 标签 和 值 。 
. 右 侧 这 组 包含 像 passer rating、passer 最 近 所 在 的 团队 以 及 passer 的 整个 职业 生涯 这 样 的 总 结 信息 。 
O38 专业 的 图 形 设计 员 看 到 这 一 切 会 发 出 尖 叫 。 无 视 他 们 ， 因 为 他 们 已 经 习惯 了 。 
名 称 标签 
这 是 唯一 的 标签 ， 横 跨 视 图 的 顶部 。 


在 Library 搜 索 栏 中 输入 label， 打 开 label (UlLabel) 视图 。 将 它 拖 到 billboard 视 图 中 。 与 之 对 应 的 Attributes inspector 中 
有 一 个 Text 栏 ， 其 中 的 FirstNameLastName 是 占 位 待 ， 你 会 上 友 现 大 部 分 输入 都 被 截断 (使 用 省 略 号 ) ， 这 是 因为 标签 实在 太 窜 
了 。UlLabel 调 整 文本 的 大 小 (你 可 以 设置 下 限 ) 来 适 配 标 签 的 边界 。 如 果 内 容 太 多 而 标签 太 小 ， 束 会 友 生 截 断 。 拉 伸 ] 硕 部 细节 
视图 中 的 标签 ， 这 样 束 不 需要 调整 文本 的 大 小 。 


passer 的 名 称 非 常 重要 ， 所 以 我 们 让 它 突出 显示 。 从 Inspector 中 的 Font 选 项 可 以 看 到 这 个 本 文 的 字体 是 System 17.0。 单 
击 和 芳 边 带 有 T 图 标的 按钮 ， 打 开 Font 选 择 界面 ， 见 图 11.9。 将 其 设置 为 System Bold 和 和 18 像素 。 


右 侧 的 分 组 


现在 需要 一 个 表示 passer rating 的 标签 ， 它 的 位 置 靠 近 右 侧 ， 刚 好 在 名 字 的 下 面 。 这 个 标签 真 的 非常 重要 。 我 的 品位 一 
般 ， 想 把 它 设置 为 红色 、 大 号 、 粗 体 。 在 文本 域 中 填 入 158.3， 然 后 将 它 设置 为 系统 粗 体 ，52 points (可 能 你 需要 拉 伸 标签 的 边 
R) 。 对 于 Alignment， 我 们 选择 靠 右 对 齐 (第 三 个 选项 ) ， 这 样 当 数 字 小 于 100 的 时 候 束 从 两 行 变 为 了 一 行 。 单 击 iInspector 中 
Text Color 控 件 左 侧 的 颜色 选择 器 ， 打 开 调 色 板 。 使 用 调 色 板 中 第 五 个 选项 卡 ， 选 择 Maraschino 蜡 笔 。 现 在 passer rating 的 颜 
色 已 经 相当 红 。 如 果 喜 欢 ， 还 可 以 给 它 添加 Shadow 和 Shadow Offset 效 果 。 
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图 11.9 (Æ) ##Attributes inspector P Font FW i A FATA HL, BLEU —AGG LALA PASAY RUSK) 09 h 


框 。 (CF) Font 弹 出 菜单 为 你 提供 了 “系统 字体 ， 还 有 一 些 动态 字体 。 (A) 在 Font 弹 出 菜单 中 选择 Custom， 打 开 Family 弹 出 
界面 ， 就 能 看 到 iOS 8 可 用 的 所 有 字体 


团队 的 名 称 设置 为 系统 粗 体 、14 号 、 靠 右 对 齐 ， 位 置 在 rating 标 签 下 。 将 文本 设置 为 Tacoma Touchdown-scores， 这 是 
数据 集中 最 长 的 团队 名 称 ， 了 这 样 束 能 满足 所 有 的 文本 长 度 需求 。 在 Attributes inspector 中 ， 有 一 个 分 步 器 选项 Lines。 如 果 将 它 


设置 为 2， 团 队 名 称 就 能 显示 两 行 。 重 新 调整 标签 大 小 ， 让 它 显示 整个 名 字 。 
我 保证 下 面 是 最 后 一 个 标签 : 显示 passer 职 业 生涯 起 止 日 期 的 标签 。 它 位 于 团队 名 称 下 面 ， 系 统 字 体 ，12 号 ， 靠 右 对 齐 。 
文本 域 中 填 上 最 大 的 日 期 范围 : 10/29/2015-10/29/2015。 


» 主意 to BURRIS A, ALA AP review assistant， 那 你 很 可 能 会 对 现在 的 结果 感到 很 肖 表 一 一 右边 这 一 栏 很 可 能 部 分 或 者 


完全 超越 了 billboard 的 右边 界 。 我 们 马上 就 会 修复 这 个 问题 。 
左 侧 分 组 


接 下 来 是 统计 数据 。 从 Attempts 标 签 开始 介绍 ; 系统 字体 ，14 号 ， 正 常 ， 自 适应 大 小 ， 位 于 名 称 标签 的 左下 。 我 们 还 需要 
4 个 这 样 的 标签 ， 为 了 提高 效率 可 以 复制 刚才 制作 的 这 个 标签 : 选择 Edit 一 Duplicate (#D) ， 或 者 按 住 option 键 拖 动 刚才 做 好 
的 标签 ， 也 可 以 完成 复制 操作 。 以 第 一 个 标签 为 基准 ， 竖 直 排 列 剩 下 的 标签 ， 从 上 到 下 依次 为 Attempts、Completions、 
Yards、Touchdown， 以 及 Interceptions。 


» ta 选中 多 个 标签 ， 可 以 使 用 Atttibutes inspectot 统 一 为 选中 的 标签 设置 风格 。 


接 下 来 ， 创 建 统 计数 据 本 身 的 标签 。 在 stat-name 劳 边 插入 5 个 UILabel。 在 这 个 过 程 中 ，lnterface Builder 会 在 视图 中 男 出 
监 色 的 提示 线 ， 用 于 显示 标准 间隔 以 及 与 临近 元 素 的 对 齐 方式 。 在 带 有 文本 内 容 的 视图 中 ， 当 视图 的 基本 线 与 它 的 邻居 对 齐 的 时 
候 ， 你 会 看 到 一 条 虚线 提示 。 当 不 能 肯定 的 时 候 ， 束 用 基本 线 对 齐 。 


我 建议 把 文本 内 容 设 置 为 00,000， 这 样 束 能 确定 所 需 的 最 小 宽度 。 列 表 中 相同 的 标签 没有 什么 帮助 ， 所 以 选中 任意 一 个 标 
签 ， 在 ldentity inspector 中 ， 将 它 的 Xcode 标签 设置 为 对 应 的 统计 数据 。 统 计数 据 标签 束 会 在 列表 中 显示 出 对 应 的 内 容 ， 所 以 
使 用 #:#Attempts、#Completions 等 来 区 分 数字 标签 。 


确保 文本 风格 与 sta-name 标 签 的 风格 一 致 : 仅仅 是 右 对 齐 。 


做 个 有 趣 的 实验 ， 确 保 Game List Controller 场 景 处 于 选中 的 状态 ， 然 后 选择 Editor 一 Resolve Auto Layout 
Issues 一 Update All Frames in Container 命 令 ， 单 击 画 布 自动 布局 组 中 第 三 个 按钮 (+441) 也 能 完成 相同 的 命令 。 


啊 ， 不 ! 所 有 的 标签 都 在 视野 中 消失 了 。 如 果 在 文档 大 纲 中 选中 它们 ， 你 会 友 现 它们 的 Y 坐 标 都 相对 于 billboard 的 顶部 移动 
了 -64， 靠 近 场景 的 顶 边 。 没 有 任何 指引 ，Auto Layout 将 所 有 的 对 象 都 放 在 了 同样 的 位 置 来 解决 约束 问题 。 你 不 得 不 添加 一 些 
限制 ， 让 它 无 法 破坏 你 的 显示 。 撤 销 (Edit 一 Undo 号 Z， 之 前 告诉 过 你 ) 这 个 布局 。 


再 次 确保 game list 场 景 处 于 选中 状态 ， 选 择 Editor 一 Resolve Auto Layout Issues 一 Add Missing Constraints, [Al 
样 ，Interface Builder 会 目 动 创建 合适 的 布局 并 提供 对 应 的 约束 。 


如 果 你 单 击 标签 的 周围 ， 束 会 看 到 监 色 的 虚线 和 表示 约束 的 标记 。 约 束 系统 完整 并 统一 ， 所 以 Update Frames 命 令 会 被 禁 
止 。 


现在 看 起 来 很 不 错 ， 风 图 11.10。 





图 11.10 添加 了 标签 约束 的 billboardq 视 图 。 标 签 周围 的 线 表示 布局 方块 ， 它 们 是 Auto Layout 计 算 布 局 的 重要 标准 


11.2.6 ”清理 


但 是 还 不 够 好 。 因 为 Auto Layout 是 根据 复杂 的 约束 系统 进行 数学 计算 得 出 的 结果 ， 其 中 可 能 会 有 一 些 冲突 或 者 不 足 的 地 
方 。 你 无 法 总 是 知道 为 何 会 出 错 。 下 面 是 我 在 Preview assistant 和 iPhone 5 模拟 器 中 看 到 的 布局 。 你 会 发 现 有 些 不 同 点 一 一 预 
览 与 模拟 器 之 间 的 差别 一 一 但 是 经 过 调整 ， 最 后 的 效果 是 一 样 的 。 

列 冲 突 


左 侧 的 统计 数据 与 右 侧 的 评分 、 团 队 名 称 和 日 期 重合 。 默 认 情 况 下 ，Interface Builder 不 得 不 用 统一 的 形状 因数 编辑 场景 ， 
以 适 配 屏 幕 的 大 小 和 形状 ,但 是 统一 的 宽度 告诉 我 们 ，320-point 的 宽度 无 法 满足 我 们 对 布局 的 需求 。 


[ 
Games 


FirstName LastName 
Attempts ad 





Completions UUUU 


Yards 00000 oma Touchdown- 
Touchdowns 00000 Scorers 


Interceptions DOOM /2015 - 10/20/2015 


iPhone 4-inch 


图 11.11 暴露 了 第 一 个 问题 ， 在 Pteview assistant 中 尤为 明显 。 
如 果 再 次 查看 布局 ， 你 会 友 现 数字 标签 的 边界 比 所 需 的 更 宽 一 些 ， 超 过 了 70points。 在 我 的 例子 中 一 一 基本 上 可 以 确定 与 


你 的 不 同一 一 Interface Builder 为 #Attempts 标 签 设 吓 了 固定 宽度 ， 然 后 让 其 他 4 个 标签 的 leading 和 trailing 边 界 与 它 对 齐 。 这 


样 做 的 效果 就 是 让 5 个 标签 有 相同 的 宽度 。 如 果 我 们 重新 调整 #Attempts 标 签 的 大 小 ， 其 他 4 个 也 会 跟着 友 生 改变 。 





选择 #Attempts， 打 开 Size inspector。 在 列表 中 选择 宽度 约束 ， 然 后 单 击 对 应 的 Edit 按 钮 ， 玖 会 弹出 一 个 菜单 ， 其 中 的 约 


束 等 于 72 (或 类 似 的 ) 。 将 数字 更 改 为 48 (我 这 里 刚刚 好 ) 然后 离开 编辑 状态 。 所 有 的 integer-stats 标 签 都 会 变 窒 ( 记 住 ， 其 


他 4 个 都 会 和 #Attempts 保 持 一 致 ) ，Preview assistant 这 一 询 已 经 不 再 重 王 。 看 上 去 还 不 够 完美 ， 但 是 已 经 有 很 大 进步 。 下 一 


章 我 们 就 会 替换 所 有 的 部 分 。 
The Billboard 中 的 约束 失效 


模拟 器 的 表现 又 有 些 不 同 。billpoard 仅 占据 了 视图 中 间 20 point 的 宽度 。 右 列 向 右 对 齐 ， 左 列 向 左 对 齐 ， 所 以 从 屏幕 上 看 
二 者 应 该 交换 一 下 。 


很 明显 ，billboard 的 边界 约束 有 些 问 题 。 我 在 billboard 的 Size inspector 中 仔细 查看 ， 发 现 leading 和 trailing 边 与 顶 布 局 引 
导 的 leading 和 trailing 距 离 固定 。 同 时 ， 引 导线 宽度 看 起 来 应 该 有 20 points， 距 离 视 图 左边 有 160 points, 


这 是 错误 的 。 如 果 我 自己 完成 布局 ， 我 将 会 固定 与 根 视图 边界 的 距离 ， 根 视图 中 就 包含 billboard。 双 击 那 些 leading 和 
trailing 约 束 ， 按 delete 删 除 它 们 。 


之 后 ， 选 中 billboard， 单 击 Pin 按 钮 (Fo ) 打开 为 视图 添加 约束 的 弹出 窗口 ( 见 图 11.12) 。 不 勾 选 Prefer Margin 
Relative， 确 保 左 右 两 边 的 盒子 显示 为 0， 同 时 构建 它们 之 间 的 结构 和 中 心 (由 此 使 其 有 效 ) 。 
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图 11.12 单 击 Pin ( H ) 按钮 将 会 显示 一 个 向 视图 中 添加 约束 的 弹出 窗口 。 在 这 个 例子 中 ， 我 们 将 前 缘 和 后 缘 与 邻居 ( 主 视 


图 的 两 侧 ) 的 间距 设置 为 0 point。 单 击 输入 栏 旁 边 的 标记 ， 它 就 会 变 为 实体 ， 表 示 你 想 添加 这 些 约束 。 注 意 ， 不 要 匀 选 Prefer 


Margin Relative 复 选 框 


Update Frames 弹 出 框 应 该 设置 为 ltems of New Constraints， 这 样 billboard 才 会 移动 到 最 新 的 约束 为 位 置 (这 个 例子 中 
应 该 都 一 样 ) 。 可 供 选择 的 是 All Frames in Container， 但 是 我 还 不 够 大 胆 ， 在 添加 了 几 个 限制 之 后 就 重新 全 部 排列 。 


然后 单 击 Add 2 Constraints 启 用 它们 。 有 两 件 事 要 记 住 : 


. 你 需要 单 击 Add……Constraints 按 钮 让 新 约束 生效 。 单 击 其 他 位 置 ， 或 者 将 其 他 窗口 提前 ， 都 会 让 弹出 窗口 消失 ,但 是 却 不 


会 添加 约束 。 


` 现在 已 经 添加 了 约束 。 弹 出 窗口 无 法 编辑 存在 的 约束 。 无 论 何 时 用 Pin 按 钮 添加 的 约束 都 会 添加 到 约束 集合 中 ， 即 便 里 面 
已 经 有 了 这 种 约束 。 


11.3” 表 视图 


现在 我 们 才 想 到 一 一 我 们 还 没有 用 来 保存 单 场 比 赛 数据 的 表 视 图 ， 比 如 UlTableView 形 式 的 表 视 图 。 在 Library 查 找 栏 中 输 
入 table 束 能 看 到 Table View。 将 它 拖 到 主 视图 的 下 部 (注意 不 要 误 用 Table View Controller) 。 拉 伸 使 其 占据 合适 的 位 置 。 对 
于 两 侧 和 底部 来 说 比较 轻松 ， 因 为 Interface Builder 会 将 它 贴 到 主 视 图 的 边缘 ， 但 是 对 于 顶部 它 惑 无 能 为 力 了 。 


这 个 时 候 ， 自 动 布 局 会 让 工作 变 得 很 轻松 。 将 表 视 图 放 到 场景 的 下 部 ， 调 整 大 小 不 至 于 和 周围 的 元 素 重 看 。 单 击 男 布 右 下 侧 
自动 布局 分 组 中 的 oj 按钮 将 Pin 弹 出 框 显示 出 来 。 将 4 个 空间 栏 设 置 为 0， 使 用 下 拉 菜 单 设置 顶部 空间 的 值 ， 确 保 它 相 对 于 
billboard 视 图 。 


SFR IB 希 望 边 框 的 空白 是 一 个 标准 大 小 ORE) ， 同 时 默认 计算 边框 相对 这 个 值 的 位 置 。 不 要 勾 选 Prefer margin 


relative ， 确 保 边 框 挨 着 根 视 图 。 


在 弹出 框 中 将 Update Frames 菜 单 设置 为 ltems of New Constraints， 然 后 单 击 下 方 的 确定 按钮 ， 现 在 这 个 标签 变 为 Add 
4 Constraints。 表 视图 会 精确 地 显示 你 想 要 的 位 置 和 大 小 ， 同 时 ， 它 也 会 随 着 场景 中 其 他 对 象 大 小 的 变化 而 变化 。 


11.4 outlet 


现在 我 们 已 经 添加 了 14 个 标签 ， 其 中 有 9 个 用 来 显示 从 Passer Rating 数 据 存 储 中 获得 的 统计 信息 ， 比 如 姓名 、 日 期 等 。 你 
已 经 知道 了 怎么 做 : 按 住 control 键 ， 将 它们 拖 入 GameListController.swift 类 的 声明 中 ， 创 建 标签 连接 到 控制 器 的 
@|BOutlets, 


每 个 NIB 以 及 每 个 Storyboard 场 景 都 有 一 个 所 有 者 ， 它 是 场景 (或 者 NIB) 的 一 个 外 部 对 象 。 载 入 机 制 会 使 用 场景 中 指向 对 
象 的 指针 填充 @IBOutlet 属 性 。Storyboard 和 XIB 对 待 拥有 者 的 方式 不 同 。 


- Interface Builder 中 针对 XIB 的 编辑 器 在 文档 大 纲 中 包含 一 个 名 为 File s Ownet 的 “对 和 象 ”。 这 个 对 象 在 XIB 中 并 非 实际 存 
在 ， 它 在 Interface Buildetr 的 文档 大 纲 中 用 占 位 符 表示 。 它 位 于 拥有 者 对 象 中 ， 这 个 对 象 会 在 运行 时 中 载 入 XIB (实际 是 NIB 产 


品 ) 。 


- 在 stotyboatd 中 ， 每 个 场景 都 属于 UIViewConttollet 子 类 。 控 制 器 的 占 位 符 出 现在 文档 大 纲 中 ， 当 选中 场景 时 ， 这 个 占 位 符 
fy 


就 会 显示 为 中 间 带 有 view 的 黄色 圆圈 。 


当 创 建 了 UlViewController、NSWindowController 或 者 NSViewController 的 子 类 之 后 ，Xcode 会 激活 一 个 复 选 框 Also 
create XIB file (OS X 项 目 可 能 后 面 还 会 有 for user interface) 。 如 果 勾 选 了 这 个 选项 ， 除 了 新 类 的 .swift 文 件 之 外 ，Xcode 还 
会 创建 一 个 XIB。Xcode 知 道 所 有 者 的 类 是 哪个 ， 所 以 它 也 会 设置 File Owner 的 对 应 类 。 


如 果 你 单独 创建 了 一 个 XIB 文 件 ，Xcode 就 无 法 得 知 哪个 文件 是 File Owner 对 应 的 类 ， 只 能 自己 手动 设置 。 在 文档 大 纲 中 选 
择 File Owner 的 图 标 ， 打 开 ldentify inspector (Utility 区 域 中 Inspector 视 图 的 第 三 个 选项 卡 ) 。 第 一 栏 是 个 组 合 框 应 该 填 入 所 
有 者 的 类 名 。 随 着 你 的 输入 ， 方 框 里 的 内 容 会 自动 补 全 。 


storyboard 中 的 视图 控制 器 也 是 如 此 : 当 把 一 个 视图 控制 器 拖 到 画布 中 创建 了 一 个 场景 后 ， 所 有 者 融 居 确定 为 空 的 
UIViewController。 你 必须 在 ldentity inspector 中 修改 类 名 ， 将 它 指向 右 侧 控 制 器 的 场景 。 


四 注意 对 象 库 中 还 有 一 些 其 他 控制 器 ， 有 一 些 可 能 是 控制 器 的 子 类 (UITableViewController 就 是 其 中 一 个 子 类 ) ， 有 些 不 
是 。 使 用 这 些 子 类 而 不 是 空 视图 控制 器 ， 根 据 需 要 设置 控制 器 类 。 


回 到 GameListController 中 。 我 们 需要 屏蔽 控制 器 的 |IBOutlets 到 这 个 场景 中 的 对 象 。 在 所 有 要 使 用 的 标签 前 面 输入 var 作 为 
Fal, SIX: 显示 出 Assistant 编 辑 器 ， 然 后 在 它 的 跳 转 栏 中 选择 Automatic， 这 样 束 能 显示 出 


GameListController.swift, 
在 GameListController 类 中 的 基 个 部 分 ， 为 dates 标 签 声 明 outlet。 


class GameListController: UIViewController { 
@TBOutlet weak var datesLabel: UILabel! 


现在 回 到 画布 左 人 出 Pocument Outline 边 栏 (如 果 不 可 见 ， 单 击 左下 角 的 按钮 ) ， 然 后 右 击 Games， 也 融 是 场景 所 有 者 的 
英文 名 称 。 一 个 小 的 、 黑 色 的 窗口 就 会 显示 (HUD) 出 来 ， 它 包含 outlets 表 ， 中 间 是 datesLabel。 表 中 每 一 行 的 右 端 都 有 一 个 
气泡 。 将 它 拖 到 设置 时 间 范 围 的 标签 上 ， 然 后 放 开 。HUD 中 的 adjoining 列 就 会 指向 对 应 标签 的 引用 (图 11.13) 。 现 在 ， 当 场 
景 载 入 时 ， 所 有 者 GameListController 中 的 datesLabel 属 性 就 会 包含 指向 那个 标签 的 指针 。 


Ose ”场景 上 方 自 色 工 具 栏 的 第 一 个 图 标 代表 相同 的 控制 器 对 象 ; 右 击 的 方法 也 适用 于 它 。 同 
你 可 以 在 这 个 点 上 执行 拖 动 操作 ， 将 它 拖 动 到 





k}, GameListController.swift ? outlet 声明 淮 边 的 气泡 中 包含 一 个 黑色 的 点 


storyboard 中 的 一 个 元 素 上 ， 由 此 完成 链接 操作 。 
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图 11.13 在 文档 大 纲 中 右 击 GamelListControlletr， 打 开 一 个 向 上 弹出 的 窗口 ， 其 中 包含 控制 器 的 outlets。 将 一 个 outlet 链 接 气 泡 拖 


到 conttollet 场 景 中 的 一 个 视图 ， 那 么 outlet s4 ptopetty 就 会 添加 指向 那个 视图 的 指针 


如 果 你 打算 重复 使 用 已 经 存在 的 File Owner 对 象 ， 将 它 放 到 场景 中 ， 这 个 是 一 个 将 视图 链接 到 outlets 上 的 好 方法 ， 如 果 
outlet 属 性 已 经 定义 了 。 


在 我 们 这 个 例子 中 ， 可 能 有 些 见 繁 ， 因 为 没有 声明 outlet 的 vars。 使 用 control-drag-into-source ( 按 住 control 键 将 它 拖 到 
场景 中 ) 可 能 是 一 个 更 好 的 选择 。 


11.4.1 连接 outlet 


在 高 兴 地 开始 制作 outlet 连 接 之 前 ， 了 解 下 面 的 内 容 将 会 事半功倍 : assistant 跳 转 栏 的 最 右 侧 有 一 个 + 按钮 ， 单 击 
它 ，Assistant 区 域 就 会 一 分 为 二 。 使 用 下 面 编辑 器 的 跳 转 栏 ， 从 Manual 目 录 开 始 ， 导 航 到 Passer.swift。 让 新 的 outlet 名 与 它 
们 展示 的 Passer 属 性 的 名 称 保 持 一 致 ， 这 个 新 编辑 器 会 提供 属性 名 称 参 考 。 


现在 control-drag ( 按 住 control 键 拖 动 ) 在 GameListController 中 创建 新 属性 。 使 用 下 面 这 个 规则 为 outlet 命 名 : 找到 
Passer 属 性 的 名 字 ， 在 后 面 添加 Label。 团 队 名 字 标 签 在 controller interface 中 就 是 currentTeamLabel，attempts 就 是 


attempsLabel， 等 等 。 


~ iE Interface Builder 还 能 将 控件 链接 到 行为 方法 上 ， 这 个 行为 方法 使 用 (@interface 类 中 的 I[BAction 标 签 声明 。 当 你 触发 


了 绑 定 IBAction 方 法 的 控件 ， 这 个 方法 就 会 被 调用 。 详 细 例 子 见 第 19 章 。 


GameListController 也 需要 能 够 访问 表 视 图 。 按 住 control 从 表 中 拖 动 一 个 连接 到 GameListController 中 ， 然 后 将 其 命名 为 


tableView, 
11.4.2 检查 连接 


再 做 最 后 一 步 检 查 ， 确 保 每 一 个 连接 的 正确 性 : 在 主编 辑 器 中 打开 storyboard，Assistant editor 中 显示 
GameListController 定 义 的 @IBOutlet， 单 击 每 一 个 连接 ， 确 保 每 个 与 乙 对 应 的 视图 都 会 高 亮 显示 。 

如 果 某 个 outlet 没 有 连接 或 者 连接 到 了 错误 的 视图 ， 那 么 将 连接 气泡 拖 到 正确 的 视图 上 。 一 个 @IBOutlet 最 多 只 能 指向 一 个 
视图 ， 它 只 是 一 个 措 针 。 一 个 视图 可 以 连接 到 多 个 outlet， 因 为 它 并 没有 有 反 同 引用 outlets。 挨 个 单 击 outlets， 如 果 需 要 可 以 重 


新 连接 ， 这 样 束 能 清晰 地 理 顺 各 个 连接 。 


one-view-per-outlet (每 个 outlet 对 应 一 个 视图 ) 的 规则 有 个 例外 : 你 可 能 有 一 个 outlet 集 合 (collection) 。 随 着 Swift 
代码 越 来 越 多 ， 集 合 与 单 对 象 (single-object) 连接 有 一 点 不 同 ; 唯一 的 区 别 是 : 在 集合 中 outlet 的 类 型 是 一 个 视图 数组 。 
@TBOutlet var numericLabels: [UILabell]! 
billboard 中 包含 5 个 标签 用 来 显示 数字 。 我 们 可 能 想 同 时 清除 所 有 的 标签 ， 最 简单 的 想法 是 保存 一 个 数组 变量 var， 然 后 使 
用 outlet 变 量 填充 它 。 
var numericLabels: [UILabel]! 
numericLabels = [attemptsLabel, completionsLabel, 


yardsLabel, touchdownsLabel, 
interceptionsLabel] 


但 是 之 后 会 引 友 一 些 问题 : 某 一 天 ， 你 可 能 想 要 添加 、 删 除 或 者 重 命名 询 表 中 的 标签。 当 你 处 于 视图 控制 器 的 生命 周期 时 ， 


GameListController.swift 中 。 但 是 这 


不 是 outlet。 为 这 个 集合 起 个 名 字 (numericLabels 这 个 名 字 不 错 ) , 


尔 应 该 在 标 和 


这 就 是 为 什么 会 有 outlet 集 合 。 像 之 前 一 样 ， 按 住 control 键 ,将 任何 一 个 数字 标签 
一 次 ， 当 出 现 outlet 弹 出 窗口 的 时 候 ， 


一 开始 束 有 一 个 成 员 ， 也 就 是 创建 集合 时 的 成 员 。 拖 动 集 


等 殉 都 会 添加 到 集 


SS 如 果 你 错误 地 添加 了 一 个 标签 ， 按 住 control 键 单 击 它 


i ay Xo 


清空 所 有 标签 的 函数 现在 变 得 很 简单 。 


func emptyIntegerLabels() { 
for label in numericLabels { 
label.text = "" 
} 


符 outlets 初 始 化 之 后 急 始 化 数组 ， 并 且 初 始 化 的 过 程 还 


要 在 任何 可 能 使 用 numbericLabels 之 前 ,但 并 不 尽 是 能 保证 


然后 在 Type 中 


合 outlet 旁 边 的 气 


(比如 Attempts) 拖 到 


选择 Outlet Collection 作 为 Connection 的 类 型 ， 而 


选择 UILabel 作 为 类 型 。 


气泡 到 每 一 个 其 他 数字 值 的 标签 上 。 每 个 标 


， 就 会 出 现 一 个 窗口 ， 找 到 humeticLabels 的 链接 ， 然 后 单 击 它 


SER ”Outlet 集 合并 不 保证 数组 中 的 顺序 。 如 果 顺 序 非 常 重要 ， 那 么 需要 在 Interface Builder 中 选中 每 个 视图 ， 然 后 将 它 的 
Tag 值 设置 为 不 同 的 值 (在 Attributes inspectot 的 View 分 类 中 也 能 


11.4.3 ”连接 GameListController 


类 似 的 操作 ) ， 


后 根据 视图 的 tag 属 性 区 分 不 同 的 视图 。 


Interface Builder 的 功能 非常 强大 ， 但 是 你 仍然 需要 写 从 model 中 获取 数据 显示 到 view 中 的 代码 。 这 需要 对 
GameListController 人 做 些 修改 。 


模板 为 detailltem 提 供 了 一 个 设置 器 : setDetailltem，configureView 方 法 会 调用 它 ， 它 就 是 将 Passer 中 的 统计 数据 显示 到 
钢 图 标签 的 万 法 。 


Xcode 模板 提供 了 通用 的 代码 ， 但 是 你 知道 细 记 条 目 应 该 是 什么 样 。 所 以 重 写 属性 的 声明 。 


var detailItem: Passer? | 
didSet { 
// Update the view. 
self.configureView () 


configureView 方 法 


下 面 是 configureView 方 法 。 有 点 长 ， 但 很 有 必要 阅读 。 


let integerProperties = | 
"attempts", "completions", "yards", 
"touchdowns", "interceptions" 


func configureView() { 
if detailItem == nil { return } 
let passer = detailItem! 


for name in integerProperties { 
let stat = passer.valueForKey(name) as! Int 
let label = self.valueForKey("\ (name) Label") as! UILabel 
label.text = "\(stat)" 


// ratingFormatter is defined in Utilities.swift 

// It formats a number into a decimal string 

// with a mandatory single digit after the 

// decimal point. 

let ratingString = 
ratingFormatter.stringFromNumber ( 

passer.passerRating) 
passerRatingLabel.text = ratingString 


currentTeamLabel.text = passer.currentTeam 


// shortDateFormatter is defined in Utilities.swift 
// It formats a date into a short string according 
// to the user's locale. In US English, this would 
// be mm/dd/yyyy. 
let startDate = shortDateFormatter.stringFromDate ( 
passer.firstPlayed) 
let endDate = shortDateFormatter.stringFromDate ( 
passer.lastPlayed) 
datesLabel.text = "\(startDate) { \(endDate)" 


fullNameLabel.text = passer.fullName 
title = passer.fullName 


ConfigureView 的 工作 原理 
现在 就 能 看 到 小 心 处 理 标签 命名 的 好 处 : 
1) 你 可 以 循环 遍历 integerProperties 中 的 数字 属性 名 称 。 


2) 使 用 键 - 值 对 的 编程 方法 (在 Objective-C 中 ， 这 个 技巧 束 是 使 用 字符 串 路 径 访 问 对 象 属性 ， 相 同 的 技 15 也 能 用 于 Swift 
中 源 于 Objective-C 类 的 对 象 ， 或 者 由 @objc 属 性 标记 的 对 象 ) ， 人 在 这 个 例子 中 ， 属 性 名 称 束 是 键 对 应 的 字符 串 。 


3) 在 属性 名 后 面 添加 Label， 同 时 使 用 KVC 的 编程 方法 从 控制 器 中 获得 对 应 的 UILabel outlet. 
4) 将 数字 值 格式 化 为 字符 串 ， 让 后 将 它 放 到 标签 的 text 属 性 中 。 
在 一 个 数组 中 添加 Passer 属 性 的 名 字 ， 然 后 根据 属性 名 字 为 outlet 变 量 起 一 个 简单 的 名 字 ， 减 少 为 每 个 属性 -标签 对 重复 复 


制 的 操作 。 属 性 数字 和 名 称 的 更 改 可 以 简单 地 通过 修改 属性 -名 字数 组 来 实现 。 


11.4.4 代码 补 全 和 上 月 段 


在 编写 这 些 代 码 的 时 候 可 能 会 有 些 缓 慢 。Cocoa Touch 是 一 个 庞大 的 API 库 ， 没 有 人 能 记得 每 个 符号 和 方法 名 称 。 
NSstring 人 在 Objective-C 中 有 超过 130 个 方法 。 如 果 没 有 一 些 帮助 措施 ， 估 计 你 每 次 都 要 停 下 来 查看 方法 名 的 拼写 。 现 在 ， 是 时 
候 开 局 我 在 第 2 章 2.2.2 节 中 关闭 的 另 一 项 功能 。 


打开 Preference 窗 口 (Xcode—Preferenceshttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., comma) ， 切 换 到 Text Editing 面 板 下 的 


Editing 选 项 卡 ， 勾 选 Suggest completions while typing, 


尝试 这 一 行 let startDate=shortDateFormatter.stringFromData (passer.firstPlayed) ， 这 次 仅 需 输入 sho，Xcode 就 会 
弹出 一 个 窗口 ， 里 面 提 供 了 完整 的 符号 ， 同 时 在 编辑 器 代码 的 对 应 位 置 用 灰色 显示 出 这 个 符号 (图 11.14) 。 有 很 多 方法 都 是 以 
sho 开 头 ， 所 以 需要 滚动 滑动 窗口 查看 。 按 住 上 下 箭头 可 以 让 你 在 方法 名 中 切换 。 


let startDate = shouldGroupAccessibilit 
Inti6 ShortFixed 
ShortFixedPtr 

? shortStringFrom_[j; (date: NSDate?) 
Bool shouldAutomaticallyForwardAppearanceMethods() 
Bool shouldAutomaticallyForwardRotationMethods( ) 

L shouldAutorotatet( ) 

AccessibilityChildren 

Bool shouldPerformSequeWithIdentifier(identifier: String!, sender: AnyObjed 








































































































A Boolean value indicating whether VoiceOver should group together the elements that are children of the receiver, regardless of their 
positions on the screen. More... 
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图 11.14 ” 当 开 启 自动 补 全 的 时 候 ， 输 入 部 分 符号 名 就 会 出 现 一 个 备 选 列 表 ， 每 个 选项 都 有 一 个 简短 的 描述 。 选 择 其 中 的 一 个 然 


后 按 return 键 就 能 完成 代码 补 全 


目 动 补 全 功能 相当 强大 ， 它 基于 上 下 文 感 丰 ， 我 友 现 当 我 最 近 使 用 了 enum 人 列表 中 的 一 个 符号 ， 下 次 输入 相同 前 缀 的 时 候 ， 
代码 提示 就 会 优先 提示 enum 列 表 中 的 其 他 符号 。 


继续 输入 缩小 提示 范围 。 当 提示 代码 的 前 缀 都 相同 时 ， 按 Tab 键 会 自动 补 全 相同 的 部 分 ， 缩 小 补 全 列表 。 如 果 对 当前 的 代码 
提示 很 满意 ， 按 return 键 然后 继续 编辑 。 


代码 补 全 有 的 时 候 也 不 那么 智能 ， 它 偶尔 会 给 出 一 些 你 根本 束 不 想 要 的 提示 。 尤 其 是 当 你 想 要 输入 一 个 字母 相同 但 是 大 小 写 
不 同 的 得 号 (比如 completion) 时 尤为 痛苦 。 当 你 完整 地 输入 了 想 要 输入 的 符号 后 ，Xcode 还 是 会 给 你 提示 另外 一 个 符号 。 如 
果 遇 到 这 种 情况 (或 者 你 不 想 看 到 弹出 框 ) ， 那 么 按 下 escape 键 ， 目 动 补 全 融会 消失 。 


O5 根本 就 不 喜欢 自动 补 全 这 个 功能 ? 如 果 勾 选 了 Escape key shows code completions 选 项 ， 那 么 你 就 能 随时 调 出 代码 补 
全 窗口 。 即 使 在 使 用 escape 补 全 代码 的 功能 关闭 的 情况 下 ,仍然 可 以 使 用 ^Space 调 出 代码 补 全 。 


11.4.5 ”代码 片段 


代码 补 全 并 没有 在 拼写 的 过 程 中 暂停 。 Xcode 支持 代码 片段 (code snippets。 见 Utility 区 域 中 Library 这 一 部 分 内 市 有 伦 括 
号 的 第 二 个 选项 卡 ) ， 使 用 这 个 功能 可 以 按照 你 的 想法 添加 和 编辑 代码 块 。 


每 当 Passer 或 者 Game 对 象 友 生 更 改 的 时 候 ，Passer Rating 融 要 调用 保 他 app 托管 对 象 的 上 下 文 。 其 中 有 一 个 例子 在 
PasserListController.insertNewObject(sender) 的 结尾 。 以 下 模式 : 


// Save the context. 

var error: NSError? = nil 

if !managedObjectContext.save(&error) { 
abort () 

} 


源 于 应 用 程序 中 重复 出 现 多 次 的 原型 。 如 果 代 码 很 容易 输入 ， 那 么 可 以 做 一 些 更 好 的 工作 而 不 仅仅 是 调用 abort(。 


注释 挥 已 有 的 代码 用 于 参考 ， 然 后 在 原 地 复制 一 份 相同 的 代码 ; 你 可 以 使 用 这 段 代 码 作 为 未 更 改 的 片段 ， 但 是 让 我 们 包 合 一 
些 占 位 符 ， 这 样 就 能 实现 自 定义 。 


var error: NSError? = nil 
if !managedObjectContext.save(&error) { 
NSLog ("In %@: could not save %@", 
"<#method name#>", 
"<#how failed#>") 


// MOCSaveException is defined in Utilites.swift 
NSException. raise (MOCSaveException, 

format: "Context: %@", 

arguments: getVaList(["<#how failed#>"])) 


占 位 符 放 在 <##> 这 个 符号 对 中 ， 其 中 有 一 些 文 本 用 来 提醒 编码 人 员 应 该 用 什么 来 替换 这 个 占 位 符 。 你 可 能 想 将 占 位 符 代码 
放 到 左 侧 的 空白 (Editor 一 Structure 一 Shift Left, #0) ， 所 以 当代 码 片段 展开 的 时 候 ，leading 空 白 不 会 出 现 


选中 代码 卢 段 文本 ， 将 它 抑 到 snippet 库 面板 (Utility 区 域 的 下 方 ， 第 二 个 选项 卡 ) 。 这 个 区 域 的 边框 会 高 之 显示 ， 然 后 松 
开 姐 标 按钮 ， 见 图 11.15。 


// Save the context. 
var error: NSError? = nit 
if !managedObjectContext.save(&error) { 


abort () l 
Switch Statement - Execute diferent 


sections of code when an expression has 
one of several constant values. 


// Save the context. 
var error: NSError? = nil Test Method - Add a test case method 
if !managedObjectContext.save(G&error) { | to a test class. 
NSLog("In %@: could not save %0", 


H n var error: NSError? = nil Union Declaration - Declare a new 
// MOCSaveException is defined in UfilmeasgedDbjectContext.save(Serrgr) {i} union type, where all fields overlap at the 
NSException. raise (MOCSaveException, NSLog("In %@: could not save % same memory location. 


format: “Context: %0", a - 


Plas 本 
arguments: getVaList([" A po mi en { y T EP EPEE - Execute code while 


a @eedition is true. 


SF raise (MOCSaveExcep{ io 
format: “Context: $E 
Passer Rating ) W Thread 1 ) OAK SCH Rad Steg et Va Lis phle 





图 11.15 ”创建 了 自己 的 代码 片段 之 后 ， 选 中 它 ， 然 后 将 它 拖 动 到 Utility 区 第 二 个 选项 卡 的 Clipping 库 中 


新 的 代码 片段 会 显示 在 列表 的 地 步 ， 带 有 一 个 统一 的 名 字 ， 如 User Snippet。 双 击 代 码 片 段 就 会 出 现 一 个 弹出 框 ， 显 示 出 
代码 片段 的 内 容 。 单 击 Edit 按 钮 ， 弹 出 框 允许 你 为 它 添加 标签 ， 选 择 可 用 范围 (BS. ERM) ， 以 及 目前 最 重要 的 一 项 一 一 自 
动 补 全 的 快捷 方式 。 输 入 savemoc 用 于 快捷 方式 ， 剩 下 的 见 图 11.16。 然 后 单 击 Done 按 钮 。 


the context. 1 ota) 
r: NSError?f = nil i 
ged0bjectContext. savel&error) { 

t{)} 


Li PE Wi DAY ee ee i 


{ } Test Method - Add a toat cose method 
to atest class. 


Tila | GD Save and Exception Union Declaration - Declare a now 
{ } union type, where all fields overlap at the 


same memory location. 


{ User| Summary | Save the MOC and raise an exception if failed 


Platform | All Language | Swift 


Completion Shortcut savemoc { } While Statement = Execute code while 


Completion Scopes | All a Condition is true. 


var error: NSError? = nil 
if ImanagedObjectContext.save(Serror) { 
NSLog("In S@: could not save %0", 
“method name", 
"how failed ") 
f/f MOCSaveException is defined in 
Utilites. swift 
NSException. raise (MOCSaveException, ello", 3. 145) 


farmat: “Pantewt: Sa"! 


| { 1 | GD Save and Exception - Save tne 
er] MOC and raise an exception if failed 











图 11.16 ”找到 你 刚 拖 进来 的 代码 片段 (User Snippet) ， 双 击 它 ， 然 后 填充 标签 ， 上 下 文 和 自动 补 全 的 快捷 方式 


现在 回 到 主编 辑 器 ， 删 除 对 代码 卢 段 所 做 的 工作 。 输 入 sav， 目 动 补 全 弹出 框 融会 显示 出 你 的 代码 片段 的 名 字 ， 对 应 的 融 是 
你 提供 的 描述 。 按 return 键 插入 代码 片段 文本 ， 同 时 占 位 待 处 于 高 亮 状态 。Tab 键 能 让 你 在 它们 之 间 切 换 ， 当 你 完成 后 ， 下 面 就 
最 终 的 状态 : 


var error: NSError? = nil 
if !managedObjectContext.save(&error) { 
NSLog ("In %@: could not save %@", 
"PasserListController.insertNewObject", 
"the new Passer") 


// MOCSaveException is defined in Utilites.swift 
NSException.raise (MOCSaveException, 
format: "Context: %@", 


arguments: getVaList(["Trying to save a new passer"] ) ) 


借助 这 个 模板 ， 你 能 写 出 品质 更 高 也 更 统一 的 代码 。 


11.5 ”测试 Billboard View 


现在 一 切 人 付 备 束 绪 。 运 行 Passer Rating。Xcode 会 开始 构建 App， 安 装 到 iOS Simulator 中 ， 并 启动 (App 需 要 花费 很 长 的 
时 间 载 入 CSV 文 件 ， 时 间 长 到 你 都 会 怀疑 IOSs 是 否 会 因为 App 长 时 间 无 法 响应 而 结束 进程 ， 不 过 我 们 有 方法 可 以 解决 这 个 问题 。 
详 见 第 16 章 ) 。 


eian 束 会 出 现 如 图 11.17 所 示 的 视图 。 所 有 的 标签 都 填 上 了 对 应 的 数据 ， 应 用 程序 现在 工作 正 
单 。 比 赛 表 仍然 为 空 ， 但 是 已 经 一 定 的 进步 : 用 户 已 经 可 以 访问 这 些 数 据 了 。 
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图 11.17 运行 Passer Rating， 选 中 一 个 passet 就 能 显示 出 对 应 的 passef 细 节 视 图 


11.6 “小结 


本 章 很 长 ， 但 是 也 完成 了 很 多 工作 。 之 前 ，passer 表 作为 应 用 程序 的 根 节 点 ， 几 乎 完全 由 项 目 模 板 实现 。 你 所 要 做 的 残 是 更 
改 一 些 格 式 和 数据 表 名 。 这 一 次 ， 你 在 没有 任何 内 容 的 视图 中 填 苑 了 Passer Rating 管 理 的 数据 。 


为 了 制作 ;总 billboard， 你 使 用 了 一 个 表 以 及 一 个 容器 视图 ， 剩 下 的 都 是 标签 。 学 习 了 如 何 布 局 以 及 如 何 使 用 Attributes 编 
辑 器 为 各 个 标签 填充 合适 的 内 容 。 同 时 ， 我 也 向 你 展示 了 如 何 处 理 自 动 布 局 的 问题 。 


数据 展示 当然 需要 数据 的 支持 ，controller 对 象 将 数据 从 模型 中 取出 显示 在 视图 中 。 使 用 带 有 Assistant 编 辑 器 的 Interface 
Builder， 让 GameListController 和 直接 访问 数据 标签 并 且 从 Passer 对 象 中 获取 数据 填充 对 应 的 标签 。 


最 后 ， 大 概 看 了 下 billboard 的 显示 及 工作 方式 。 最 后 一 部 分 内 容 ， 比 赛 表 ， 将 会 在 第 13 章 介绍 。 不 过 首先 我 会 (同时 你 
应 该 ) 深入 介绍 billboard 视 图 的 布局 。 


B12 ”新 视图 的 目 动 布局 


第 11 章 介绍 了 在 Passer Rating 中 创建 新 场景 。 为 了 保持 专注 ， 不 被 别 的 事情 打扰 ， 我 使 用 了 一 些 技巧 绕 过 了 自动 布局 中 的 
问题 。 若 以 练习 为 目的 ， 你 不 需要 因为 屏幕 尺寸 和 4.7 英 寸 的 Phone 多 做 一 些 工 作 。Passer Rating 并 不 是 一 个 专业 的 评分 产 
品 。 

但 是 很 快 你 融会 友 现 需要 知道 更 多 天 于 自动 布局 的 内 容 。 本 章 将 深入 介绍 Auto Layout (自动 布局 ) ， 你 可 以 选择 之 后 再 
看 ， 甚 至 也 可 以 完全 不 看 本 章 的 内 容 。 这 取决 于 你 的 实际 情况 。 


局 注意 如 果 尝 试 在 Xcode 4 中 进行 Auto Layout， 你 会 发 现 这 简直 是 性 梦 。 如 果 你 对 自动 布局 有 心理 阴影 ， 我 也 不 会 责怪 
你 。 在 Xcode 5 中 ， 一 切 得 到 了 改善 ，Xcode 6 中 的 进步 更 大 。 不 过 ， 新 的 工作 流 只 有 你 在 File inspectot 的 Opens in 弹出 窗口 中 ， 至 
少 选择 Xcode 5.0 才 会 起 作用 。 如 果 你 选择 了 兼容 Xcode 4.6， 那 么 你 或 者 协作 者 可 能 不 得 不 在 Xcode 4.6 中 打开 这 个 文件 一 一 也 就 


是 说 重新 回 到 了 糟糕 的 旧 工 作 流 中 。 


12.1 “为 什么 选择 目 动 布局 


几 十 年 来 ，NeXTStep、Cocoa 以 及 Cocoa Touch 使 用 autosizing (上 自动 调整 大 小 ) 让 视图 布局 适应 形状 的 变化 ， 由 窗口 的 


大 小 上 友 生 改变 或 者 旋转 设备 导致 可 显示 区 域 大 小 友 生 变化 。 


自动 调整 大 小 Autoresizing 非 常 简单 ， 注 意 ， 每 个 视图 都 有 springs， 它 允许 在 横 轴 、 纵 轴 或 者 双向 调整 大 小 ; 还 有 struts， 
它 能 控制 视图 的 边界 是 否 严 格 与 对 应 容器 的 边界 保持 一 定 的 距离 。 随 着 父 视图 大 小 友 生 变化 ， 子 视图 也 会 根据 spring-and-strut 
的 原则 进行 相应 的 调整 。 


12.1.1 Autoresizing 的 局 限 


Autoresizing 绝 大 部 分 时 间 都 能 正常 工作 ， 但 也 有 些 很 常见 且 原 本 很 简单 的 工作 它 却 无 法 胜任 。 应 用 程序 代码 不 得 不 为 了 应 
付 这 些 情况 而 做 各 种 特殊 处 理 ， 有 些 需求 可 能 要 反复 试 错 才能 复 现 。 


从 根本 上 讲 ， 布 局 不 仅 是 根据 内 容 调整 窗口 大 小 的 问题 ， 后 面 还 有 一 系列 问题 的 要 考 碟 。 假 设 你 有 一 个 必须 要 能 阅读 其 完整 
内 容 的 标签 ， 它 处 于 容器 中 的 第 三 层级 。 这 个 标签 所 在 的 容器 不 能 大小， 否则 将 无 法 看 到 标签 的 完整 内 容 ， 所 以 其 上 一 层 容器 也 
不 能 太 小 ， 以 此 类 推 直到 窗口 的 根 视图 。 唯 一 必须 要 满足 的 需求 是 窗口 本 身 的 大 小 : 先 做 些 尝试 ， 看 看 在 不 显示 标签 的 情况 下 ， 
最 小 的 窗口 是 多 大 ， 记 住 这 个 数值 ， 然 后 将 它 设置 为 窗口 的 参数 。 


现在 将 标签 的 内 容 从 英文 更 改 为 德 文 : 复制 一 份 XIB， 填 入 翻译 后 的 内 容 ， 看 看 宽度 是 多 少 ， 然 后 重复 上 面 的 操作 ， 从 而 决 
定 窗口 的 大 小 限制 。 


产品 面向 国际 市 场 ， 有 10 个 国家 或 地 区 会 使 用 你 的 产品 。 还 有 一 个 标签 也 需要 始终 都 能 看 到 其 完整 内 容 ， 这 些 内 容 都 是 
程序 生成 的 ， 其 中 涉及 一 些 数学 方面 的 细节 知识 。 


数学 工作 计算 机 能 够 代劳 。 在 实际 工作 中 ， 大 小 和 布局 约束 能 够 在 层级 之 间 上 下 传递 ， 甚 至 跨 层 传 递 。 这 其 中 会 有 些 折衷 和 
优先 级 : “我 想 要 这 个 标签 届 中 显示 ， 也 要 足够 宽 能 显示 其 全 部 内 容 (SBA) ， 它 至少 要 与 周围 的 控件 保持 8points 的 距 
离 。 为 了 保持 这 个 距离 ， 首 先 将 它 从 中 间 移 开 ， 如 果 一 定 要 满足 需求 ， 还 可 以 缩小 标签 大 小 。 如 果 调 整 窗口 的 大 小 会 导致 标签 宽 
度 小 于 120 point， 那 么 束 停 止 调 整 窗口 (同上 3 层 ) 的 大 小 。 同 时 ， 我 对 剩 下 的 另外 10 个 视图 也 有 这 样 的 要 求 …… 


12.1.2 Auto Layout 


这 个 需求 完全 可 以 由 Auto Layout 实 现 。 昌 然 Auto Layout 以 复杂 性 著称 ,但 是 使 用 Auto Layout 功 能 比 在 程序 中 使 用 代码 
实现 相同 的 效果 简 早 很 多 。 


从 字面 上 看 (意思 是 : 对 此 不 要 想 太 多 ) ， 任 意 两 个 视图 之 间 的 天 系 都 能 使 用 约束 联系 在 一 起 。 一 个 约束 能 应 用 每 个 视图 中 
的 特定 属性 (CORA. AP, B., BS. eS) ， 使 用 偏 移 量 、 系 数 、 优 先 级 来 指定 间隔 和 对 齐 方式 。 视 图 可 能 会 有 一 
些 “ 故 有 的 ”大 小 ， 有 些 视图 ( 通 剃 是 包含 文本 的 视图 ) 不 能 比 其 中 的 内 容 更 宽 或 者 更 窒 。Auto Layout 能 够 使 用 这 些 限制 生成 
一 个 满足 尽 可 能 多 条 件 的 完整 布局 ， 优 先 满足 优先 级 高 的 约束 。 


12.1.3 ”需要 牢记 的 问题 
“满足 所 有 的 条 件 ” 这 是 你 的 职责 所 在 : 对 于 每 一 个 视图 ， 在 任意 轴 上 ， 约 束 链 应 该 完全 指定 视图 的 位 置 和 大 小 (充分 


性 ) 。 这 些 限制 之 间 不 能 冲突 (保持 一 致 性 ) 。 如 果 没 有 满足 这 些 条 件 ，Auto Layout ahs, Interface Builder 也 


会 友 出 警告 。 


12.2 ”重新 制作 Player Billboard 


在 第 11 章 中 ， 我 让 你 把 billboard 视 图 放 在 GameListController 视 图 的 顶部 ， 基 本 上 没有 考虑 陈述 式 (declarative) 布局 的 
问题 。 指 定 了 一 系列 的 约束 来 避免 BUG 的 出 现 ， 然 后 让 Interface Build 完 成 了 剩 下 的 工作 。 


你 为 什么 需要 做 更 多 的 事情 


对 于 应 用 程序 的 初期 来 说 ， 这 样 做 能 够 满足 需求 ， 但 是 也 有 很 多 缺陷 。 除 非 你 在 视图 对 齐 万 面 非常 民 愤 ， 否 则 在 这 些 约束 条 
件 下 生成 的 效果 可 能 并 非 你 设想 的 那样 。 当 你 把 billboard 横 向 放置 时 ， 过 窄 的 元 素 束 会 导致 可 用 空间 的 大 量 瀛 费 ， 见 图 12.1。 


FirstName LastName 
Attempts 00,000 7 J 3 
Completions 00.000 5 oP 


Yards 00,000 Tacoma Touchdown- 


00,000 Scorers 


Touchdowns 


Interceptions 00,000 10/29/2015 - 10/29/2015 


iPhone 4-inch 





图 12.1 4% Interface Buildet 约 束 条 件 自 动 生成 系统 也 能 让 应 用 程序 正常 运行 ， 但 是 在 横 屏 的 时 候 却 无 法 有 效 利 用 可 用 空间 
Wits 图 12.1 中 显示 的 是 在 我 的 约束 条 件 下 得 到 的 效果 。 你 自己 的 效果 可 能 有 些 不 同 , 但 是 大 体 也 差不多 。 


首先 检查 现 有 的 约束 条 件 。 有 很 多 万 法 可 以 做 到 这 点 : 如 果 你 在 画布 编辑 器 中 选中 了 一 个 视图 ， 男 布 中 将 会 显示 几 条 线 表 示 
这 个 视图 所 具有 的 约束 。Size inspector (第 五 个 选项 卡 ) 有 一 个 包含 这 些 约束 的 列表 ， 双 击 一 个 条 目 束 能 选中 对 应 的 约束 。 约 
束 对 象 单独 处 于 文档 大 纲 的 Constraints 分 类 中 (你 可 能 需要 翻 看 一 下 才能 看 到 ， 它 会 帮助 你 查找 输入 视图 名 或 者 类 型 ) 。 选 中 
其 中 的 一 个 约束 残 会 在 编辑 器 中 高 亮 显 示 。 在 贺 布 中 选中 一 个 约束 需要 一 些 扩 15， 但 是 当 你 指向 某 个 约束 的 时 候 ，Interface 
Builder 会 帮助 你 高 之 显示 边框 ， 并 且 提 供 比 它 本 身 更 宽 的 一 个 可 视 区 域 。 


究竟 是 谁 的 约束 ? 


Interface Buildetr 展 示 约 束 的 形式 看 起 来 像 是 受 某 个 约束 限制 的 视图 “拥有 ”这 个 约束 。 但 事实 并 非 你 想象 的 那样 。 约 束 就 它 
自身 来 说 是 一 个 独立 的 对 象 ， 你 甚至 可 以 将 一 个 IBOutlet 指 向 它 。 除 了 大 小 的 约束 ， 其 他 约束 都 指向 两 个 视图 。 这 两 个 视图 之 间 


没有 从 属 关系 ， 这 样 从 任何 一 个 视图 中 获得 约束 都 很 方便 。 


不 过 ， 每 个 约束 都 从 属于 某 个 视图 。 两 个 视图 之 间 的 约束 由 它们 共同 的 容器 管理 。 
一 旦 选中 了 一 个 约束 ， 就 能 删除 它 ， 也 能 通过 Attributes inspector (第 四 个 选项 卡 ) 对 它 进行 编辑 。 


Wiis Editor>Canvas 菜 单 包含 一 系列 Interface Builder 将 会 显示 的 选项 ， 其 中 包含 很 多 与 约束 相关 的 选项 。 现 在 我 们 感 兴 
趣 的 是 Show Bounds/Layout Rectangles， 根 据 UIViews 的 .ftame 属 性 显示 边框 视图 ， 或 者 显示 Auto Layout 用 于 测量 控件 和 对 齐 的 边 


界 。 同 样 ， 其 中 还 有 些 选项 用 来 显示 约束 的 关系 ， 即 一 些 基本 实用 的 调试 信息 。 


有 件 事 需要 注意 : 当 你 让 Interface Builder 添 加 遗漏 的 约束 时 ， 它 只 能 猜测 你 的 想法 ， 不 过 猜测 水 平 还 可 以 。 它 完成 的 特别 
好 的 一 件 事 残 是: 绝 大 多 数 约 束 都 是 级 联 (cascade) 的 天 系 。 一 般 来 况 ， 视 图 布局 中 最 重要 的 一 件 事 不 是 绝对 位 置 ， 而 是 视图 
间 的 天 系 。 


考虑 一 个 日 历 视 图 ， 它 包 侣 一 行 表示 星期 几 的 标 和 釜 ， 下 面 是 几 行 表示 日 期 的 按钮 。 你 不 会 天 心 日 期 按钮 的 x、y 值 ， 而 会 关心 
它 是 否 处 于 星期 几 对 应 的 标签 中 间 ， 以 及 它 与 标签 之 间 的 距离 。 


一 个 好 的 Auto Layout 系 统 会 尽 可 能 少 地 为 视图 指定 绝对 位 置 。 日 历 视 图 的 策略 是 为 某 个 星期 标签 (第 一 个 、 最 后 一 个 或 者 
中 间 的 某 个 标签 ) 提供 绝对 位 置 ， 然 后 使 用 相对 约束 (GAP, BE) 对 剩 下 的 元 素 进行 布局 。 如 果 移 动 了 固定 位 置 的 星期 标签 ， 
布局 中 其 他 的 元 素 丈 能 目 动 调整 自己 的 位 置 。 


12.3” 重 构 子 视图 布局 


在 第 11 章 中 ， 我 让 你 在 billboard 中 展示 了 每 个 标签 。 对 于 左 侧 的 状态 栏 ， 它 是 一 个 包含 大 小 、 间 隔 还 有 对 齐 襄 明 的 子 系 
统 ， 这 个 子 系统 相当 脆弱 ， 也 很 容易 让 人 迷惑 。 对 于 5 个 除了 内 容 外 其 余 完 全 一 样 的 标签 对 ， 这 样 做 不 大 合适 。 在 本 节 中 ， 我 们 
将 会 通过 一 个 上 自 定 义 视图 减少 复杂 性 ， 这 个 视图 中 包含 统计 数据 中 的 名 称 和 值 。 同 时 ， 我 们 也 将 会 向 你 展示 如 何 创建 能 在 
Interface Builder 中 直接 配置 的 自 定义 视图 。 


UIView 的 子 类 一 称 为 UIView 一 应 该 是 什么 样 的 ”没有 什么 让 人 兴 香 的 地 方 : 它 也 是 市 有 两 个 文本 区 域 的 失 形 ， 其 中 一 
个 用 来 显示 名 称 ， 还 有 一 个 用 来 显示 值 ， 见 图 12.2。 








摆 放 名 称 和 值 这 两 个 标 等 的 过 程 取 决 于 UIView 子 类 ，statView 定 义 在 它 目 己 的 源 文件 StatView.swift 中 。 移 不 要 创建 这 个 
文件 。StatView 可 能 很 简单 ， 但 是 有 些 在 看 来 正确 前 需要 稍 做 调整 。 如 何 布局 其 中 的 内 容 ( 它 将 会 是 一 个 单独 的 视图 对 象 ， 所 
以 无 法 使 用 Auto Layout) ? 什么 字体 看 上 去 效果 更 好 ? 如 何 确定 它 “ 合 适 的 ”大 小 (用 最 小 的 花 销 展示 完整 的 内 容 ) ? 事件 在 
视图 中 生成 了 一 个 级 联 的 回调 ， 怎 样 挑选 出 哪个 回调 应 该 触 友 一 个 StatView 内 部 布局 ? 
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图 12.2 ”简单 视图 的 线 框图 ， 用 于 显示 标签 和 数字 。StatView 中 的 属性 将 会 包含 标签 、 值 、 文 本 颜色 以 及 大 小 


12.3.1 Playground 


Swift 的 优点 之 一 就 是 用 Run-Edit-Print Loop (REPL， 运 行 - 编 辑 -打印 循环 ) 交互 式 (或 者 接近 交互 式 ) 的 完成 这 个 工 
VE: 输入 代码 ，REPL 解 释 代 码 ， 你 惑 能 看 到 结果 。 有 一 个 REPL 命 令 行 (在 Mavericks 中 输入 swift， 或 者 xcrun swift) , 


Xcode 6 包含 一 个 可 视 化 的 编辑 并 显示 (edit-and-display) 环境 ， 称 为 playground。 使 用 它 能 很 轻松 地 开 上 复杂 的 软件 ， 即 便 


这 个 软件 会 产生 图 形 输出 ， 比 如 视图 的 内 容 。 
这 融 是 大 概 情况 ， 我 们 把 它 放 在 哪里 ? 


HEF ile>New—Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/... (ÆN) ， 在 下 拉 模 板 中 选择 
IOS 一 Source 一 Playground， 然 后 按照 一 般 文件 的 方法 保存 它 ， 将 它 与 你 的 项 目 联系 在 一 起 。 不 要 把 它 加 入 任何 target 中 。 


加 警告 iOS FOS X blayground 是 两 个 不 同 的 环境 ， 它 们 依赖 于 不 同 的 框架 。 如 果 你 发 现 playground 的 表现 跟 预 想 的 不 一 
致 ， 那 么 需要 查看 一 下 文件 的 顶部 ， 看 看 最 先 imnpott 的 是 Cocoa 还 是 UIKit。 


新 playground 中 唯一 可 执行 的 一 行 是 给 String 变量 赋值 (因为 String 是 Swift 的 内 置 变 量 ， 所 以 Swift 知道 它 ) : var 
str=“Hello，playground”。 编 辑 器 面板 的 右 侧 还 有 一 个 灰色 的 列 ， 赋 值 语 句 Hello，playground 旁 边 还 有 一 行 。 


让 我 们 从 一 个 简单 的 例子 开始 : 使 用 Newton”s Method 获 取 一 个 平方 根 。 将 playground 中 的 内 容 蔡 换 为 : 
import UIKit 


func newton_sqrt (square: Double, 
epsilon: Double = 0.001) 
-> Double 


func close_enough(one: Double, 


two: Double) 
-> Bool { 
printin("close_enough(\(one), " + 
"\ (two), \(epsilon))") 


let diff = abs(one - two), 

denom = max (abs (one), abs (two) ) 
if denom == 0 { return true } 
return (diff / denom) <= epsilon 


} 


var lag = square 
var guess = square / 2.0 


while !close_enough(guess, lag) { 
lag = guess 
guess -= (guess * guess - square) / (2.0 * guess) 


} 


return guess 


} 


// newton_sgqrt(200, epsilon: 0.0001) 


Xcode 的 颜色 和 错误 检查 与 其 他 编辑 器 中 一 样 。 到 现在 为 止 ,没有 什么 是 让 人 印象 深刻 的 。 


现在 去 掉 对 newton _ sqrt 的 注释 。 随 着 为数 的 执行 ， 灰 色 列 变 为 激活 状态 : guess 和 lag 的 初始 赋值 分 别 标记 为 100.0 和 


200.0。 人 循环 得 到 次 数 : (8 次 ) 。 
全 注意 像 这 样 的 收敛 算法 依赖 于 边界 条 件 的 正确 性 ; 很 可 能 第 一 次 执行 的 时 候 不 会 出 错 ， 但 是 之 后 会 发 现 自己 在 无 限 循 
环 。 如 果 发 生 这 种 情况 ， 按 号 period 停 止 循环 。 你 有 一 些 时 间 来 修改 代码 ， 可 以 在 循环 中 硬 添加 一 个 bre 代 语句 。 


嵌入 式 的 close _ enough 函数 中 的 println(0 调 用 呢 ” 你 可 能 不 想 知 道 它 打印 了 8 次 ， 你 只 想 知 道 打印 的 具体 内 容 。 


打开 Assistant editor (工具 栏 中 两 个 成 对 戒指 的 条 目 ) 。 如 果 跳 转 栏 的 根 没有 设置 为 Timeline， 那 么 打开 开关。 时 间 线 中 
包含 一 个 日 框 ，Console Output 用 来 显示 输出 。 


这 并 非 所 有 的 内 容 。Newton sqrt 的 核心 在 于 循环 最 后 的 计算 。 


guess -= (guess * guess - square) / (2.0 * guess) 


如 果 你 将 鼠标 从 playground 灰 色 的 边界 中 滑 过 ， 你 会 看 到 两 个 符号 : QuickLook 和 一 个 气泡 。 在 我 们 这 个 简单 的 例子 
中 ，QuickLook 弹 出 框 无 法 提供 有 用 的 信息 ， 但 是 对 于 一 些 复杂 的 数据 类 型 来 说 ，QuickLook 能 显示 数组 内 容 、 结 构 体 成 员 


太太 
zJ o 


单 击 这 一 行 中 的 气泡 。 时 间 线 中 就 会 显示 另外 一 个 盒子 ， 这 一 次 它 包 含 一 个 线性 表 ， 显 示 那 一 行 每 次 迭代 计算 的 值 。 这 一 点 
非常 有 用 ， 见 图 12.3。 








BR MyPlayground.playground close_enough{_:_:) \@) Timeline MyPlayground. playground (Timeline) 
Find 2 Qx 


import UIKit 
close_enough(100.0, 200.0, 0.0091) 
_ close_enough(51.6, 100.0, 0.0001) 
func newton_sart(square: Double close_enough(27.4607843137255, 51.0, 0.0001) 
e: Double .00i close_enough(17.371948743796, 27 .4607843137255, 0.00901) 
obi eae close_enough(14.4423809486623, 17.371948743796, 0.0091) 
close_enough(14.1452565514874, 14.4423809486623, 6.0001) 
close_enough(14.1421359680227, 14.1452565514874, 0.0901) 
func close_enough(one: Double close_enough(14.142135623731, 14.1421359680227, 0.0091) 


two: Double 


一 > Bool { 
println( \Cone) (8 times) 


\ctwo), \Ce))") 


let diff = abs(one - two), (8 times) 
denom = max(abs(one), abs(two)) (8 times) 
if denom == @ { return true + 
return (diff / denom) <= € (8 times) 
3 


var X%.1 = square 
var x, = square / 2.0 


while !close enough(x, X1) Í 
(7 times) 
i * x - square) / (2.0 * x, ) (7 times) 





return x 14.142135623731 
3 


newton_sqrt(200, €: 0.0001) 14.142135623731 





图 12.3 blayground 中 允许 你 写 一 1 完整 的 类 ， 监 视 它 的 执行 并 实时 改善 。Timeline assistant 中 能 显示 编译 错误 、 控 制 台 输出 和 计 


算 结 果 。Swift 语 法 对 Unicode 字 符 支持 很 好 ， 所 以 部 分 变量 就 可 以 有 一 些 “ 真 ”数学 名 


12.3.2 StatView 


现在 让 我 们 清空 playground， 准 备 测试 StatView。 这 里 有 一 些 我 们 想 看 到 的 很 明显 的 属性 。 下 面 是 一 些 用 于 客户 端 显 示 的 
API, 


- 统计 数据 名 是 Stting 


- 值 的 类 型 是 Int 


. 字体 大 小 
. 字体 颜色 
让 我 们 先 看 下 这 个 类 : 


import UIKit 
import QuartzCore 


internal let defaultFontSize:Double = 17.0 
internal let verticalMargins:CGFloat = 2.0 
internal let sideMargins:CGFloat = 2.0 
internal let interMargin:CGFloat = 4.0 
@IBDesignable 
public 
class StatView: UIView { 
/// Set the label string to be displayed 
/// at the left side of the view 
@IBInspectable public 


var name: String = "" { 
didSet { 
nameLayer.string = name 
setNeedsLayout () 


/// Set the integer value to be displayed 
/// at the right side of the view 
@IBInspectable public 
var value: Int = 0 { 
didSet { 
statLayer.string = "\(value)" 
setNeedsLayout () 


/// Set the size of the font to be used 
@IBInspectable public 
var fontSize: Double = defaultFontSize { 
didSet { 
textFont = UIFont.systemFontOfSize ( 
CGFloat (fontSize) ) 
setUpLayers () 
setNeedsLayout () 


} 


@IBInspectable public 
var fontColor: UIColor = UIColor.blackColor() { 
didSet { 
nameLayer.foregroundColor 
statLayer.foregroundColor 


fontColor.CGColor 
fontColor.CGColor 


} 


// More to come 


@IBDesignable 和 @IBlnspectable 是 什么 ? 


回溯 到 Xcode 3， 在 它 之 前 的 Project Builder 能 够 创建 可 链接 的 框架 ， 其 中 包含 能 够 绘制 和 操作 视图 (NSView) 的 资源 和 
代码 。1B 皇 件 能 提供 它们 目 己 的 属性 查看 器 ， 设 置 所 包含 的 视图 的 唯一 属性 。 


从 Xcode 4 开始 ， 就 没有 这 个 插件 了 ， 它 已 经 被 重 写 了 。 根 据 我 们 的 经 验 ， 在 特殊 的 软件 中 随意 插入 代码 是 一 个 非常 不 好 的 
做 法 。 开 发 者 不 得 不 回头 在 它们 的 布局 中 插入 空 UIView 占 位 符 ， 更 改 ldentity inspector 中 的 类 ， 然 后 等 待 模拟 器 显示 最 后 的 结 
果 。 


到 了 Xcode 6, Interface Builder 接 受用 于 实时 泻 染 (Live Rendering) 的 可 设计 的 (designable) 视图 。1B 在 布局 场景 
使 用 自 定 义 视 图 的 代码 和 和 资源， 同时 提供 了 设置 属性 的 方法 。 通 过 将 一 个 视图 声明 为 @IBDesignable public， 将 它 指定 为 可 设 
计 的 。 为 了 将 1B 中 用 于 修改 的 属性 暴露 出 来 ， 可 以 将 它们 声明 为 @IBlnspectable public, 


StatView 将 它 自身 分 为 两 个 Core Animation 文 本 层 对 象 (CATextLayer) 。 文 本 层 有 它们 自己 的 限制 ， 除 了 它们 所 在 应 用 
程序 ， 它 们 提供 了 混合 的 特性 和 约定 ， 内 容 和 字体 大 小 都 被 标记 为 @IBlnspectable。 


内 容 的 布局 和 管理 不 得 不 灵活 响应 视图 框 的 更 改 。 这 些 更 改 应 该 来 源 于 外 部 ， 因 为 视图 在 它 所 在 的 父 视 图 中 ， 而 父 视图 由 
Auto Layout 管 理 。 下 面 是 高 亮 部 分 ， 示 例 代码 能 告诉 我 们 完整 的 情况 : 


@IBDesignable 
public 
class StatView: UIView { 


// 


public required override init(frame: CGRect) { 
fontColor = UIColor.blackColor () 
super.init(frame: frame) 
setUpLayers () 
setNeedsLayout () 

} 


public required init(coder aDecoder: NSCoder) { 
Ae! wee 
} 


private let nameLayer = CATextLayer () 
private let statLayer = CATextLayer () 


private var textFont = 
UIFont.systemFontOfSize (CGFloat (defaultFontSize) ) 


private var idealSize = CGSize(width: 100, height: 22) 
private 


func setUpLayers () 
{ 


let layerFont = UIFont.systemFontOfSize(CGFloat (fontSize) ) 


for subLayer in [nameLayer, statLayer] { 


subLayer.fontSize = CGFloat(fontSize) 
subLayer.font = layerFont 
subLayer.foregroundColor = fontColor.CGColor 
subLayer.backgroundColor = UIColor.clearColor().CGColor 
subLayer.contentsScale = UIScreen.mainScreen().scale 

} 

nameLayer.truncationMode = "end" 

layer .backgroundColor = UIColor.clearColor().CGColor 


layer.addSublayer (nameLayer) 
layer.addSublayer (statLayer) 


override 
public func layoutSubviews () 


{ 


// Minimum bounding boxes of the element 


[NSFontAttributeName: 
"\ (value) " 


let stringAttrs = 
let statString = 


textFont] 


var statSize:CGSize = 

statSize.width += 3.0 

let nameSize: CGSize = name.sizeWithAttributes (stringAttrs) 
// Minimum bounding box of the content 

idealSize = // 


// Frame for the statistic in the current bounds 
let statFrame = // 


// Frame for the name in the current bounds 
var nameFrame = // 
// Set the respective frames 
nameLayer.frame = 
statLayer.frame = 


CGRectIntegral (nameFrame) 
CGRectIntegral (statFrame) 


public 


override func intrinsicContentSize() -> CGSize { 


return idealSize 


之 前 我 们 已 


在 类 中 的 定义 后 面 添加 如 下 代码 : 


var statBounds = CGRect(x: 0, y: 0, width: 200, height: 20) 
let theView = StatView(frame: statBounds) 

theView.name = "Interceptions" 

theView.value = 123 


有 一 些 问 题 需 要 注意 : 你 没有 一 个 视图 层级 保存 它 
些 活动 ， 包 括 11db 调 试 器 外 的 部 分 内 部 结构 名 称 ， 


， 但 是 你 可 以 创建 一 个 StatView 并 i 


单 击 最 后 一 行 的 查看 气泡 ， 从 时 间 线 中 你 会 看 到 : statView 的 泻 染 。 


statString.sizeWithAttributes (stringAttrs) 


经 见 过 了 Playground 如 何 监视 示例 代码 计算 数字 ， 那 图 形 输出 应 该 是 什么 样 ? 


和 及 置 它 的 属性 。 空 日 部 分 也 表明 了 一 


但 是 并 没有 什么 用 ， 除 了 知道 赋值 的 “ 值 ” 是 StatView 本 身 。 





Interceptions 


缩小 字体 ， 使 其 适应 StatView 的 边框 。 


Interceptions 123 





CAIERS, (EBASA, SAWRECATAMENRHILE EM. 


Interce... 123 





看 看 实际 情况 。 使 用 File 一 New 一 Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (ÆN) , 创建 一 个 空 的 Swift 文 件 ， 命 名 为 
StatView.swift (不 需要 使 用 类 模板 ) ， 删 掉 import Foundation 这 一 行 ， 然 后 粘贴 上 StatView 的 定义 ， 确 保 它 属于 Passer 


Rating 这 个 target。 


12.3.3 ”安装 StatView 


回 到 Main.storyboard， 移 除 所 有 的 数字 统计 的 名 字 和 值 标签 (之 前 已 经 同和 版 本 管理 系统 中 提交 过 ， 所 以 不 用 惊 尿 ) 。 现 在 
storyboard 中 约束 的 数量 已 经 从 56 个 降 到 了 13 个 。 


在 Utilities 区 的 Library 面 板 中 找到 UIView， 将 它 拖 到 之 前 Attempts 名 称 和 值 显示 的 billboard 上 。 将 它 调整 为 一 个 合理 的 大 
小 ， 然 后 将 它 的 类 (Identity inspector， 第 三 个 选项 卡 ) 设置 为 statView。 当 你 处 于 这 个 查看 器 的 时 候 ， 将 Label 更 改 为 
Attempts, Interface Builder 知 道 如 何 通过 UILabels 的 内 容 分 辨 它们 ， 但 是 StatViews 无 法 做 到 这 一 点 。 


查看 工具 栏 中 间 的 状态 视图 : Xcode 编译 可 查看 的 视图 ， 用 于 在 Interface builder 中 泻 染 它们 。 当 泻 染 完成 的 时 候 ， 与 视图 
没有 了 明显 的 更 改 一 一 类 编写 的 时 候 没 有 默认 值 。 但 是 Attributes inspector 中 有 一 个 Stat View 部分， 其 中 包含 Name、Value 以 
及 Font Size 这 几 栏 。 数 字 栏 上 甚至 还 有 用 来 调整 数字 大 小 的 计数 器 ， 见 图 12.4。 将 Attempts 设 置 为 11230 (仅仅 作为 占 位 
符 ) ， 字 体 大 小 为 14。 然 后 调整 对 应 的 位 置 和 字体 大 小 。 


Stat View 


i | : Name | Attempts 
FirstName LastNan 


— -p Value 
Attempts 112300 





Font Size 


Completions 9000 Foni Golar Default 





图 12.4 ”将 StatView 标 记 为 @IBDesignable， 将 其 内 容 和 字体 大 小 标记 为 QIBInspectable， 这 样 StatViews 能 在 运行 的 时 候 显示 它们 ， 
3+ ik Attributes inspector”) VA 查看 这 些 属性 


Wis 4 Interface Buildet 首 次 看 到 一 个 可 实时 编辑 的 视图 时 (包括 清理 包含 供 IB 使 用 的 代码 的 产品 缓存 ) , RMA 
框 不 会 带 中 间 的 内 容 。 更 进一步 ， 就 拿 StatView 来 说 ， 布 局 依赖 于 视图 的 优先 尺寸 ，IB 将 会 提示 约束 集 不 清晰 。 没 有 约束 定义 这 
些 视 图 的 大 小 ， 只 有 当 视 图 类 编译 后 准备 显示 的 时 候 ， 才 能 看 到 大 小 约束 。 等 待 一 分 钟 左 右 ， 你 就 会 看 到 错误 标记 消失 了 。 


为 可 设计 视图 是 Intetface Buildet 与 应 用 程序 中 运行 的 代码 ， 所 以 你 也 可 以 在 IB 中 调试 。 选 中 视图 ， 然 后 选择 Editor 一 Debug 


Selected Views。 


现在 可 以 继续 进行 。 我 们 可 以 重复 拖 动 /删除 /新 建 类 /重新 调整 大 小 的 过 程 ， 但 是 Attempts 在 StatView 中 显示 的 很 正确 ， 所 
以 复制 4 次 即 可 。 使 用 Edit 一 Duplicate (D) ， 或 者 按 option 键 拖 动 原 有 的 元 素 到 一 个 新 位 置 。 


O 注意 不 要 将 编辑 菜单 中 的 Duplicate 与 File—>Duplicatehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/... (? 36S ) 混 消 ， 文 件 菜 单 中 的 这 个 命令 用 来 保存 当前 文件 


的 副本 。 


将 新 StatViews 的 名 字 更 改 为 Completions、Yards、Touchdowns 和 Interceptions。 你 可 能 需要 调整 它们 的 宽度 与 最 宽 的 
视图 匹配 。Leading 和 trailing 边 界 需要 首 对 齐 。 


不 要 设置 任何 约束 。 


12.4 设计 约束 
在 第 11 章 中 ， 我 们 相信 Interface Builder 能 正确 地 推断 出 布局 方式 ， 我 们 只 需要 做 一 些 调 整 吉 免 大 错误 。 现 在 我 们 不 打算 那 
样 做 。 为 了 完成 Auto Layout， 我 们 需要 详尽 的 、 经 过 深思 熟 虑 的 计划 。 


其 中 有 一 件 要 考虑 的 事 就 是 传统 的 iPhone 屏 幕 短 轴 为 320 points。 我 们 绘制 的 billboard 有 168 points 高 (你 本 地 的 可 能 
些 不 同 ， 不 过 没 天 系 ) 。 人 在 竖 和 直方 同上 ， 考 虑 到 状态 栏 和 工具 栏 ，4 瑞 寸 的 界面 上 比赛 表 应 该 占 界面 的 一 半 一 一 这 样 束 足够 了 。 


但 是 在 水 平 朝 向 上 (图 12.1) ， 情 况 叉 不 一 样 。billboard 算 上 导航 栏 ， 算 上 状态 栏 大 概 占 据 了 屏幕 可 用 面积 的 1/3。 一 行 最 
小 的 高 度 是 44 points， 这 里 只 能 显示 两 行 ， 更 高 的 目 定义 行 不 在 我 们 的 考虑 的 学 围 之 内 。billboard 在 水 平 万 向 上 应 该 有 一 个 独 


立 的 、 更 短 的 布局 。 


在 iOS 8 和 Xcode 6 之 前 ， 这 是 一 个 坏 消 息 。 如 果 你 不 想 凑合 ， 而 是 完成 高 质量 的 布局 ， 那 么 束 不 得 不 在 代码 中 添加 独立 的 
约束 系统 ， 而 且 在 屏幕 朝向 友 生 变化 的 时 候 ， 做 出 相应 的 修改 。 为 大 屏幕 的 设备 布局 的 时 候 ， 比 如 iPad， 也 有 相同 的 问题 ， 尽 
管 IOs 会 为 两 种 不 同 的 界面 提供 两 套 资源 来 缓解 这 个 问题 ， 但 是 却 很 不 实用 。 


IOS 8 的 解决 方法 是 大 小 类 (size class) 。 细 节 内 容 非常 复杂 ,但 是 只 要 lnterface Builder 相 关 ， 你 需要 知道 的 是 每 个 轴 要 
么 是 压缩 过 的 ( 变 窄 ， 束 像 竖 直 朝 向 的 iPhone， 或 者 变 短 ， 就 像 水 平 朝 向 的 iPhone) ， 要 么 是 正常 的 (就 像 iPad) . Interface 
Builder 人 允许 你 在 不 同 的 环境 中 区 分 不 同 的 约束 ， 或 者 说 约束 可 以 用 于 任何 环境 ， 压 缩 的 或 者 正音 的 。 


两 个 轴 上 的 3 个 类 会 生成 9 种 环境 ， 有 一 些 约束 在 某 些 环境 中 并 未 激活 ; 有 的 约束 会 在 多 个 环境 中 激活 。 没 有 图 形 化 的 展示 
能 够 完整 且 展 好 地 表达 这 一 切 。 如 果 你 想 任 借 眼 睛 找 出 各 个 环境 ， 那 么 将 会 失去 部 分 。 


现在 后 退 ， 考 虑 下 我 们 的 目标 。 


现在 主要 工作 是 让 billboard 更 得。 由 于 在 水 平 轴 疆 上 没有 太 多 空间 ， 所 以 如 果 我 们 能 将 部 分 信息 移动 到 第 三 栏 中 ， 那 么 残 
能 实现 我 们 的 目标 。 图 12.5 显 示 了 这 个 目标 ， 它 可 以 总 结 如 下 : 


- 5 行 的 StatView 可 以 分 成 两 行 或 者 3 行 。 
- passer fating 可 以 向 上 移动 ， 靠 近 billboard 的 顶部 ， 为 passet 的 名 字 不 大 可 能 跨 过 “正常 ”的 屏幕 边界 。 
- 同样 的 ，passet 名 字 的 trailing 边 界 可 以 向 trating 标签 靠近 一 些 ， 而 不 是 向 billboard 的 边界 靠近 。 


“ 通常 不 需要 让 团队 名 称 的 重 直 空间 跨 过 两 行 。 


FirstName LastName 


Attempts 00,000 1 5 ‘3 
Completions 00,000 om 


Yards 00,000 Tacoma Touchdown- 
Touchdowns 00,000 scorers 


: 10/29/2015 — 10/29/2015 
Interceptions 00,000 


FirstName LastName 1 5 9 2 
Attempts 00,000 Touchdowns 00,000 E te 


Completions 00,000 Interceptions 00,000 Tacoma Touchdown-Scorers 
Yards 00,000 10/29/2015 - 10/29/2015 


图 12.5 ”billboard 视 图 原始 的 布局 (上) 使 用 两 列 的 布局 ， 在 传统 的 iPhone 界面 上 可 以 显示 更 多 的 信息 。 宽 屏 的 界面 (F) 在 中 间 
增加 了 一 列 ， 用 来 显示 之 前 在 第 一 列 底部 的 元 素 


在 我 的 布局 中 ，billboard 的 高 度 从 坚 直 方向 的 168 point 杰 成 了 现在 水 平方 向 的 107 point; 足够 一 行 半 额 外 的 标准 高 度 。 
值得 一 试 。 


这 就 是 我 们 的 目标 ， 现 在 开始 考虑 策略 。 首 先 要 记 住 的 是 ， 每 个 视图 都 应 该 有 与 每 种 大 小 的 组 合 对 应 的 完整 约束 ， 即 使 约束 
集 对 它们 来 说 并 不 完全 理想 。 这 样 做 会 让 Interface Builder 的 警告 ee 消失 ， 并 防止 你 遗漏 了 部 分 信息 ， 或 者 
Apple 之 后 又 引入 了 更 多 屏幕 尺寸 ，Auto Layout 不 会 因此 为 你 提供 不 合适 的 布局 。 


图 12.5 中 用 于 常规 高 度 界面 的 规划 非常 保守 ， 它 适合 作为 任何 你 无 法 显示 提供 规划 的 后 备 选 项 。 所 以 ， 任 何 宽度 、 作 体高 度 
(wAny/hAny) 的 布局 都 应 该 拥有 我 们 规划 中 显示 的 任何 宽度 、 常 规 高 度 (wAny/hRegular) 。 


(1) Any Layout (包含 hRegular) 
广 里 束 是 布局 的 备 选 
passer-name 的 标签 处 于 billboard 的 左上 方 。 

passername 横 跨 视 图 的 完整 宽度 。 

name 和 Attempts、Completions、Yards 这 几 个 StatView 靠 左 对 齐 。 

- Touchdowns 和 Intetceptions 这 两 个 StatViews 靠 左 对 齐 。 

- Touchdowns 这 个 StatView 与 Yatds 对 齐 。 

- 所 有 的 StatView 及 passet-name 标 签 在 垂直 方向 上 的 间 距 都 固定 。 

- 所 有 的 StatView 都 有 相同 的 宽度 ， 至 少 能 容纳 最 长 的 内 容 ， 还 有 一 点 空隙 。 根 据 经 验 来 看 至 少 要 有 140 points. 
rating 标签 固定 在 billboard 的 trailing 边 界 ， 宽 度 应 该 能 容纳 其 中 的 内 容 。 

- rating 标 签 的 顶部 应 该 与 Attempts StatView 的 顶部 对 齐 ， 从 而 确定 了 hame 标 签 的 底 边 。 
:fating、team 和 date-tanpge 标 签 的 ttailing 标 签 应 该 对 齐 。 


- billboard 44 JA #8 4 Interceptions StatView 之 间 有 一 个 固定 的 距离 ; StatView 列 应 该 取 两 个 之 间 高 的 哪 一 个 ， 它 决定 了 billboard 


- team name 标 签 的 leading 边 界 至 少 与 Yards StatView 的 ttailing 边 界 距 离 4 points. 
team name 标 签 应 该 足够 高 ， 能 够 容纳 两 行 。 
(2) 压缩 高 度 ( 比 如 传统 的 iPhone 横 屏 ) 
3 列 布局 完全 不 同 。 


rating 标签 的 顶部 与 passer-name 标 签 的 顶部 高 度 一 致 。 


- Name 标 签 的 宽度 就 是 内 容 的 蜗 度 ， 但 是 有 一 点 很 重要 : 与 tating 标 签 的 leading 边 界 保持 一 个 固定 距离 。 


= 


- Touchdowns StatView 的 顶部 与 Attempts 的 顶部 对 齐 。 


- Team name 标 签 的 高 度 减 小 到 一 行 。 这 一 点 很 重要 ， 因 为 它 的 完 度 已 经 足够 显示 其 中 的 内 容 。 


- Touchdowns StatView 的 中 心 与 billboard 的 中 心 保持 一 致 ， 同 时 更 改 它 的 上 边 ， 让 它 与 Attempts 平 齐 ， 移 动 它 并 将 
Inhtetceptions 放 到 中 间 那 一 列 。 


12.5 ”两 行 、 两 个 标签 
将 原本 是 两 行 的 标签 显示 为 一 行 几乎 不 太 可 能 。 标 签 可 能 会 让 其 中 的 内 容 超出 范围 、 截 断 或 者 纠缠 在 一 起 ， 没 有 很 好 的 方法 
能 够 保证 既 稳 定 又 满足 需求 。 


解决 办 法 是 创建 两 个 team-name 标 签 ， 其 中 一 个 用 于 单行 显示 ， 另 外 一 个 用 于 双 行 显示 。 选 中 已 经 存在 的 team-name 标 
签 ， 然 后 按 下 delete 键 删除 。 


全 注意 之 前 已 经 向 版 本 管理 系统 中 提交 过 了 ， 对 吗 ? 

我 们 对 两 种 情况 很 感 兴趣 : 

“ 短 (“ 压 缩 高 度 ”) 屏幕 应 该 显示 一 行 的 标签 ， 而 不 用 管 它 的 宽度 。 

. 任何 其 他 高 度 的 界面 都 应 该 提供 显示 两 行 的 标签 ; 事实 上 ， 只 需要 一 个 ， 因 为 billboard 很 可 能 太 窄 ， 需 要 换行 。 


可 能 你 已 经 注意 到 ，lnterface Builder 画 布 的 底部 是 一 个 标签 为 wWAnyWhAny 的 工具 栏 。 也 就 是 说 这 个 布局 将 会 应 用 于 任何 
大 小 或 者 朝向 的 设备 上 。 标 签 的 选择 用 于 具体 大 小 。 单 击 工 具 栏 ， 束 会 看 到 一 个 size-class 选 择 器 ( 见 图 12.6) ， 它 会 通过 高 亮 
显示 的 方块 有 反映 姐 标 的 移动 。 左 边 的 列 和 顶部 的 行 代表 这 个 轴线 上 的 “压缩 ”屏幕 ， 右 边 和 底部 表示 “常规 。 ;中间 的 行 和 列表 
示 “ 任 意 情况 ”， 或 者 不 关心 尺寸 的 情况 。 默 认 分 类 wAny/hAny 在 中 间 靠 右 。 


Any Width | Any Height | Compact Width | Regular Height Any Width | Compact Height 
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图 12.6 (Æ) 默认 情况 下 ，Intetface Builder 画 布 用 来 创建 通用 GwAny/hAny) 的 布局 。 (CP) 传统 的 iPhone 需要 
wCompact/hRegular, (Æ) Interface Builder 推 荐 将 传统 的 横 屏 朝向 设置 为 wvAny/hAny。9 个 存储 格 之 间 的 点 号 显示 了 所 选 的 类 别 


将 会 影响 到 的 配置 


选择 wAny hCompact。 大 小 分 类 工具 栏 从 日 色 更 改 为 蓝 色 ， 表 示 你 要 做 的 每 件 事 都 将 仅 应 用 于 选中 的 大 小 分 类 组 合 。 


< 注意 ”不 要 把 这 些 抽 象 的 大 小 分 类 不 当 回 事 。 对 于 2015 年 ， 你 最 少 要 针对 320 points 的 iPhone 进行 设计 。 单 击 game-list 场 景 
上 边 的 GamelListControllet 图 标 (第 一 个 ) ， 然 后 在 Atttibutes inspectot 的 Size 弹 出 框 中 ， 选 择 一 个 non-plus 的 iPhone，Otientation 对 


应 你 选择 的 大 小 分 类 。 


将 一 个 UlLabel 从 对 象 库 中 拖 到 合适 的 位 置 ， 作 为 team name 的 标签 ,然后 像 之 前 一 样 对 它 格式 化 。 将 它 设置 为 一 行 ， 然 后 
{Label Text 中 输入 一 些 内 容 ， 比 如 one-liner with place and team name。 它 对 应 的 约束 是 单行 (比如 高 度 为 20 points) 。 
见 下 面 的 常见 约束 。 


查看 标签 Attributes inspector 的 底部 ， 那 里 有 两 个 复 选 框 : 第 一 个 就 是 简单 的 Install。 如 果 视 图 要 求 在 所 有 环境 下 都 显 
示 ， 束 需要 勾 选 这 个 选项 ， 但 是 我 们 不 需要 勾 选 。 另 外 一 个 是 市 有 WwWwAny hC-installed 标 签 的 复 选 框 ， 它 已 经 处 于 勾 选 状态 : 在 
任何 高 度 压 缩 过 的 布局 上 都 要 显示 这 个 视图 。 


PR 如 果 你 关于 布局 的 想法 十 分 复杂 ， 那 么 单 击 Installed 按 钮 旁边 的 + 按钮 ， 然 后 选择 任何 大 小 分 类 的 组 合 来 添加 一 个 


新 的 Installed 开 关 。 


将 画布 的 视图 分 类 切换 到 wAny/hAny。 一 行 的 team 标 签 将 会 消失 ( 它 只 存在 于 压缩 高 度 的 类 型 中 ) 。 拖 入 一 个 两 行 的 
UlLabel， 将 它 与 男 外 一 个 同样 格式 化 ， 但 是 让 它 更 窄 ， 两 行 那么 高 。 同 时 将 Label Lines 设 置 为 2。 把 内 容 梗概 设 为 two-liner 
with place and team name; 它 不 仅 会 检验 布局 的 正确 性 ， 而 且 还 能 让 标签 更 容易 在 文档 大 纲 中 找到 。 将 标签 限制 为 两 行 高 

(36 points) 。 如 果 查 看 Attributes inspector 的 底部 ， 你 会 发 现 它 的 属性 是 Installed 和 wAny hAny， 将 它 作为 默认 选项 。 


这 两 个 都 需要 将 trailing (4) 边界 设置 到 rating 标 签 (158.3) ;这 样 束 修复 了 水 平 位 置 ， 因 为 rating 在 billboard 中 已 经 有 
了 一 个 定义 过 的 空白 。 将 顶部 边界 与 rating 标 签 设置 为 8 points， 这 样 就 会 固定 它 的 垂直 位 置 。 将 底 边 与 date-range 的 标签 设置 
为 8 points; 当 忆 度 被 压缩 的 时 候 ，date 标 尝 与 billboard 的 底部 之 间 的 距离 融会 固定 ， 这 样 融 完 整地 定义 了 billpoard 的 高 度 。 

当 设 置 billboard 后 ，GameListController 将 会 设置 这 两 个 标签 。 按 住 control 键 将 其 中 一 个 拖 到 GameListController.swift 
中 ， 然 后 创建 一 个 outlet collection; 我 将 它 命 名 为 teamLabels。Outlet 将 会 声明 为 [UlLabellj! 的 @1IBOutlet， 声 明芳 边 就 会 出 
现 一 个 连接 气泡 。 将 气泡 拖 到 另外 一 个 标签 ， 然 后 将 这 个 标签 添加 到 collection 中 。 现 在 ， 当 storyboard 局 动 的 时 


候 ，teamLabels 将 会 是 包含 这 两 个 标签 引用 的 数组 。 


currentTeamLabel.text = passer.currentTeam 


BMA 


for label in teamLabels { 
label.text = passer.currentTeam 
} 
我 刚刚 讲解 了 最 难 的 部 分 一 一 必须 要 添加 两 个 标签 以 及 它们 的 约束 集合 ， 至 少 在 任何 时 刻 都 可 以 显示 其 中 的 一 个 。 剩 下 的 
部 分 相当 单调 。 先 向 版 本 管理 系统 中 提交 一 次 代码 。 





12.6 ”实际 的 约束 


天 于 永久 视图 中 的 约束 ， 我 们 的 计划 强制 我 们 从 头 开始 。 我 再 强调 一 志 : 如 果 你 基于 一 个 完整 的 约束 集 修改 ， 使 用 修改 再 尝 


试 (cut-and-try) 的 万 法 适 配 其 他 大 小 ， 会 让 你 陷入 麻烦 中 。 


让 Interface Builder 中 显示 game-list 场 景 ， 在 画布 的 左 侧 打 开 文 档 大 纲 ， 在 billboard 视 图 中 展开 每 个 视图 。 有 约束 的 视图 
将 会 有 一 个 包谷 约束 的 子 分 类 。 选 中 那个 文件 夹 中 所 有 条 目 (除了 team-name 标 签 上 的 约束 ) ， 同 时 按 下 delete 键 删除 它们 。 


删除 billboard 视 图 本 身 的 约束 ， 而 不 删除 场景 项 层 下 面 的 约束 。 它 们 在 适当 的 位 置 保存 billboard 和 表 视 图 ， 如 果 我 们 偶尔 
更 新 视图 框 ， 那 么 没有 需要 冒险 可 能 丢失 跟 蹊 它们。 


尝试 不 要 修改 Resolve Auto Layout lssues 菜 单 中 的 任何 选项 ， 不 管 是 Editor 菜 单 中 的 还 是 画布 中 的 上 ^ 十 摆件。 如 果 在 没准 
备 好 之 前 束 触 友 一 个 布局 ， 那 么 视图 将 会 超出 它们 约束 的 边界 ， 一 个 或 者 多 个 维度 将 会 被 置 为 0。 


12.6.1 默认 (Any/Any) 


先 从 默认 情况 开始 一 一 wAny/hAny。 检 查 上 面 Any Layout 中 的 检查 列表 。 你 可 以 使 用 [oj 弹出 菜单 (或 者 Editor 一 Pin 子 
菜单 ， 取 决 于 你 更 喜欢 使 用 哪 种 方式 ) 完成 大 部 分 检查 。 这 里 有 一 些 需要 注意 的 问题 : 





. 不 要 设置 任何 绝对 约束 point inset、 大 小 或 者 间隔 
面 ， 那 么 将 passer-name 标 签 的 leading 边 界 与 billboard 的 leading 边 界 保 持 一 个 固定 的 距离 (8 points) ， 然 后 将 所 有 的 StatViews 都 与 它 








你 不 必 这 样 做 。 如 果 你 想 要 让 StatViews 列 在 billboard 的 左边 界 下 


对 齐 。 更 改 hame 标 签 的 缩 进 ， 所 有 的 StatView 都 会 跟着 它 变 化 。 


- 特别 注意 hAny 和 hCompact 布 局 之 间 的 划分 。 前 3 个 StatViews (Attempts, Completionts, Yards) 之 间 相 互 对 齐 ， 后 两 个 


(Touchdowns, Interceptions) 相互 对 齐 。 这 两 组 是 否 相 互 对 齐 依赖 于 高 度 分 类 是 否 是 Compact。 


x 


` 通过 按 住 command 键 单 击 每 个 StatViews， 然 后 选择 Editot 一 Pin 一 Widths Equally， 可 以 将 StatViews 设 置 为 等 窜 。 在 Heights 
Equally 上 做 相同 的 操作 。 


` 


- 你 可 以 相信 tating 标 签 足够 宽 ， 因 为 文本 容器 “知道 ”它们 展示 内 容 的 最 小 宽度 。 默 认 情 况 下 ，Interface Buildet 设 置 它 的 约 
R (Content Compression Resistance) 的 优先 级 为 750， 这 很 重要 ,但 如 果 布 局 在 自然 宽度 上 无 法 工作 ， 它 就 会 使 用 更 高 优先 级 的 


12.6.2 Any Height ( 非 Compact) 


如 果 你 很 仔细 ， 并 且 确 认 目 己 完成 了 视图 当前 选择 的 大 小 类 别 的 完整 约束 ， 那 可 以 让 Interface Builder 触 上 友 这 些 约束 ; 当 你 
将 name 标 签 固 定 在 billboard 的 右边 界 ， 且 想 要 看 到 布局 是 人 否 如 你 所 愿 的 时 候 ， 这 扣 非 党 实用。 选中 视图 (只 选中 视图 ) ， 然 后 
选择 Editor 一 Resolve Auto Layout lssues 一 (Selected Views) Update Frames ( 习 晤 =， 或 者 上 弹出 框 中 的 对 应 选项 ) 。 
如 果 这 个 方法 不 好 用 ， 那 么 你 可 以 撤销 操作 。 


两 列 的 布局 中 有 一 点 非常 重要 ， 与 个 StatViews 都 要 排 成 一 行 ， 但 是 你 不 能 直接 这 人 么 做 。 你 已 经 将 
Attempts 人 /Completions/Yards 这 一 组 默认 按照 leading 边 对 齐 ，TouchdownsV/lnterceptions 组 按照 leading 边 对 齐 。 为 了 能 让 
整个 列 都 对 齐 ， 仅 需要 将 Touchdowns 和 Attempts 的 leading 边 界 对 齐 ， 默 认 的 对 齐 方式 就 会 处 理 好 剩 下 的 工作 。 


12.6.3 Landscape (wAny/hCompact) 


切换 到 wAnyhCompact， 然 后 再 按照 检查 列表 检查 一 和 届 。 最 主要 的 区 别 在 于 Touchdowns 和 lnterceptions 会 移动 到 中 上 
列 。 去 除 Touchdowns 和 Attempts 之 间 的 leading 边 的 对 齐 ， 然 后 添加 这 两 个 StatViews 的 顶 边 对 齐 。Touchdowns 人 在 billboard 
中 居中 对 齐 ， 它 完全 指定 了 中 间 列 的 布局 。 


12.6.4 解决 问题 


自始至终 ， 你 都 是 选中 各 个 视图 并 触发 Selected Views: 使 用 Editor-> Resolve Auto Layout lssues 或 者 上 ^-| 弹出 窗口 ， 执 
行 Update Frames (E=) 命令 。 当 你 确定 了 整个 视图 的 位 置 ， 那 么 选中 视图 控制 器 占 位 符 图 标 (场景 项 部 工具 栏 最 右 侧 的 
图 标 ) ， 然 后 选择 All Views in GameListController: Update Frames。 这 个 过 程 中 根据 需要 可 能 会 执行 撤销 和 修改 操作 。 


当 所 有 的 问题 基本 都 解决 后 ， 注 意 文 档 大 纲 中 控制 器 名 称 旁 边 的 红色 或 者 黄色 标记 。 单 击 它 ， 束 会 出 现 一 个 Auto Layout] 
题 列表 。 红 色 的 标记 显示 的 是 主要 的 错误 : 视图 水 平 或 者 竖 直 方向 上 的 约束 要 么 不 够 ， 要 么 残 是 有 冲突 。 单 击 其 中 的 一 个 问题 ， 


AJ 日 * Ak ATTE — 
问题 视图 束 会 高 亮 显 示 。 


对 于 不 充足 的 约束 ， 你 将 会 看 到 一 个 摘 述 问题 的 简单 信息 。 对 于 有 冲突 的 约束 ， 将 会 出 现 一 个 显示 冲突 约束 的 弹出 框 ， 你 可 
以 检查 那些 可 以 牺牲 的 约束 。 


黄色 的 标记 表示 视图 仪 仪 是 放 错 了 位 置 。 如 果 你 局 腕 一 个 这 样 的 视图 ， 当 触 友 约束 的 时 候 ， 你 会 看 到 Interface Builder 认 为 
这 个 视图 应 该 在 的 位 置 的 虚线 。 单 击 警告 旁边 的 标记 ， 残 会 显示 一 个 弹出 框 ， 提 供 将 这 个 视图 移动 到 对 应 位 置 的 选项 。 更 改 约束 
来 适 配 视图 ， 或 者 允许 Interface Builder 使 用 它 的 最 佳 推断 来 著 换 视图 的 约束 集合 。 你 拥有 将 所 选 的 解决 方案 应 用 于 容器 中 所 有 
的 视图 中 的 选择 。 


12.6.5 ”细节 修改 


快要 大 功 告 成 了 (图 12.7 上 ) 。 在 iPhone 5 的 横 屏 上 ， 一行 长 长 的 team name 将 要 挤 到 中 旧 这 一 列 ， 所 以 被 强制 截断 。 这 
样 很 不 友好 ， 因 为 这 可 能 是 唯一 可 以 看 到 team 完 整 名 称 的 地 方 ， 而 且 中 间 这 一 列 的 左边 还 有 不 少 空 日 。 


这 是 因为 新 约束 的 优先 级 最 高 一 一 1000。Auto Layout 必 须 强制 实施 这 些 约束 。 对 于 标签 来 吕 (还 有 一 些 其 他 视图 ， 大 部 
分 都 是 文本 容器 ) ， 它 “知道 ”宽度 为 多 少 才 能 显示 完整 的 内 容 。 这 就 是 Content Compression Resistance 
Priority (Horizontal) 约束 。 默 认 情 况 下 ， 优 先 级 为 750。Touchdowns 和 Interceptions 这 两 个 StatViews 居 中 显示 的 优先 级 比 
标签 显示 完整 内 容 的 优先 级 要 高 ， 所 以 它 的 内 容 束 会 友 生 截 断 。 





找到 居中 的 约束 一 一 它 在 Touchdowns StatView 的 Size inspector 中 ， 单 击 即 可 编辑 。 或 者 在 搜索 栏 中 输入 Touch 残 能 在 
文档 大 纲 中 找到 它 ， 双 击 即 可 编辑 。 无 论 使 用 哪 种 方法 都 能 编辑 这 个 约束 的 优先 级 。 你 要 做 的 就 是 将 优先 级 设置 为 低 于 
750，749 即 品 。 


< Passers Quinn Adams 


Quinn Adams 


Attempts 983 Touchdowns 110 1 3 3 B 6 


Completions 659 Interceptions 1 | 
one-liner with place and te... 


Yards 9310 4/2/18 - 6/21/21 


< Passers Quinn Adams 


Quinn Adams 


Attempts 988 Touchdowns 110 1 3 3 m 6 


completions 659 interceptions 1 
one-liner with place and team name 


Yards 9310 4/2/18 - 6/21/21 





图 12.7 (EE) 默认 情况 下 ， 中 间 这 一 列 拓 中 的 设 定 无 法 让 team-name 显 示 完 整 的 内 容 。 (T) 将 居中 约束 的 优先 级 调整 为 低 于 显 
示 完 整 内 容 的 约束 的 优先 级 ， 这 样 就 能 在 需要 的 情况 下 ， 让 中 间 这 一 列 左 移 ， 从 而 显示 出 完整 的 team-name 


现在 ， 当 你 运行 Passer Rating 的 时 候 ， 过 长 的 team-name 标 签 束 会 将 Touchdowns 所 在 的 列 推 同 左 边 ， 见 图 12.7 下 。 


12.7 ”小结 


本 章 做 了 大 量 工 作 。 你 已 经 明日 了 为 什么 很 多 开 友 者 都 尽量 避免 使 用 Auto Layout， 尤 其 是 如 果 经 历 过 Xcode 4 不 完整 的 支 
持 。 现 在 两 个 朝向 上 有 4 种 iPhone 格式 。 “尽量 ”已 经 走 到 了 尽头 。 早 在 iPhone 6 出 现 之 前 的 两 年 ，Apple 就 已 经 给 过 暗示 或 者 
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Auto Layout 非 曲 复 杂 ， 但 是 也 有 一 毕 规 律 ， 除 了 了 考点 ， 它 能 适应 大 多 数 情况 。 
` 记 住 一 条 规则 : 每 个 视图 在 两 个 轴线 上 都 要 有 指定 边界 位 置 的 约束 ， 完 整 且 一 致 。 


` 计划 ! 画 个 草稿 ， 确 定 你 想 要 完成 的 效果 ， 以 及 完成 效果 所 需 的 最 小 约束 集 。 如 果 你 明确 地 知道 自己 想 要 的 效果 ， 那 么 离 
一 份 详细 的 计划 就 不 会 太 远 。 





尽量 少 做 绝对 约束 间隔 、 大 小 、 对 齐 偏 移 。 如 果 想 针对 一 个 网 格 布局 ， 确 定 一 个 元 素 国定 绝对 位 置 和 大 小 ， 然 后 让 其 
他 元 素 都 按 组 对 齐 、 同 样 大 小 、 居 中 等 。 这 样 ， 只 需要 更 改 固 定 锚 点 的 视图 就 能 让 其 他 视图 随 着 一 起 更 改 。 


- Interface Builder 中 的 “建议 ”约束 开始 的 时 候 用 着 还 不 错 ， 它 们 甚至 能 够 保存 对 齐 和 锚 点 规则 (anchot-and-align) 。 如 果 
需求 很 简单 ， 你 可 能 只 需要 修改 推荐 的 约束 集 。 如 果 没 什么 别 的 需求 ， 推 荐 的 约束 集 能 让 你 的 视图 保持 稳健 。 


` 最 重要 的 是 ， 不 要 随意 添加 约 来 。 如 果 没 有 一 份 计划 ， 你 可 能 会 不 可 避免 地 破坏 One Rule， 导 致 无 法 做 出 一 个 能 正常 工作 
的 布局 。 


第 13 草 NIRS RITE 


你 已 经 创建 了 一 个 game-list 视 图 ， 但 是 还 缺少 填充 数据 的 qame。 本 章 你 不 骨 使 用 game 表 ， 而 是 为 表格 元 素 创建 自 定义 的 
钢 图 ， 并 在 这 个 过 程 中 学 习 到 一 些 技术 。 


13.1 Game 


master-detail 项 目 模 板 提 供 了 已 经 被 我 们 改 为 PasserListController 的 root-controller 类 。 它 是 UlTableViewController 的 
子 类 。 这 个 类 提前 丈 与 对 应 的 表格 联系 在 一 起 ， 使 用 经 过 稍 加 修改 的 NSFetchedResultsController 束 可 以 将 Passers 填 充 到 表格 
中 。 


GameListController 并 不 是 一 个 table-view 控 制 器 ， 它 只 不 过 是 恰巧 包含 一 个 表 的 UIViewController。Table-view 控 制 器 


已 经 连接 到 了 对 应 的 表 ， 所 以 你 需要 手动 将 其 更 改 为 连接 到 目 己 的 表 。 


首先 要 做 的 就 是 修改 GameListController， 保 证 它 实现 了 展示 单元 格 并 响应 事件 的 方法 。 


class GameListController: UIViewController, 
UITableViewDataSource, 
UITableViewDelegate 


13.1.1 Table View 中 的 outlet 


你 需要 将 表 视 图 连接 到 控制 器 。 在 控制 器 的 结尾 已 经 完成 了 这 个 工作 ， 在 Interface Builder 中 构建 视图 的 时 候 束 已 经 设置 了 
tableView 属 性 。 但 是 表 视 图 需要 知道 从 哪里 获取 数据 (dataSource 属 性 ) 以 及 如 何 处 理 它 的 事件 (delegate 属 性 ) 。 回 到 
storyboard， 选 中 Game List Controller 场 景 ， 然 后 将 表 的 连接 拖 到 场景 下 方 工具 条 黄色 控制 器 的 图 标 上 。 从 弹出 的 菜单 里 选择 
dataSource。 为 delegate 重 复 相同 的 工作 。 


SB 之 前 ， 你 已 经 在 场景 视图 的 GameListController 中 创建 并 链接 了 @IBOutlets。 


Ou 对 于 UIKit 对 象 来 说 ， 它 们 通常 都 会 依赖 delegate 和 data sources. 4o RIX FA delegate RA data soutces， 它 们 将 一 无 所 
Ao KE Cs ER, Interface Buildet 并 没有 在 显著 的 位 置 提醒 添加 它们 。 忘 记 添 加 delegate 或 者 data soutce 是 bug 出 现 常 见 的 原 


因 ， 不 论 经 验 多 么 丰富 ， 都 有 可 能 犯 这 个 错误 。 


13.1.2 ”添加 所 需 的 Protoco| 方 法 


一 旦 passer 捕 捉 到 了 更 改 ， 工 具 栏 中 间 的 活动 视图 融会 出 现 一 个 警告 。 这 是 Swift 和 在 提 示 你 没有 提供 保证 会 实现 的 data- 


SOUrce 方 法 。 


在 lssues (第 四 个 ) 导航 器 中 ， 会 出 现 一 个 红色 标记 的 错误 信 
Ff, “.../GameListController.swift:12:1:Type’ GameListController does not conform to 


protocol ‘UlTableViewDataSource’ 。 单 击 提示 三 角 ， 就 能 看 到 缺少 的 方法 : 一 个 是 


tableView( ,numberOfRowslnsSection:)， 另 外 一 个 是 tableView( ,cellForRowAtindexPath:)。 


在 GameListController 声 明 的 底部 添加 以 下 函数 : 


// MARK: - UITableViewDataSource 


func tableView(tableView: UITableView, 
numberOfRowsInSection section: Int) 
-> Int { 
if let passer = detailitem { 
return passer.gameArray.count 


} 


else { return 0 } 


Ose //matk: 这 条 指令 会 将 这 一 行 剩 下 的 内 容 放 到 跳 转 栏 最 后 一 段 的 函数 组 中 。 如 果 在 这 个 条 指令 前 添加 一 个 连词 


> 
Ea 


号 ， 那么 这 个 标签 就 会 被 一 条 线 


如 果 Xcode 可 以 使 用 上 自动 完成 功能 就 大 好 了 ， 它 知道 UlTableViewDataSource 的 APl。 开 始 输 入 “tableView(”， 然 后 就 得 
到 了 主轴 数 名 的 结果 ， 自 动 帮 你 填写 了 第 一 个 参数 名 ， 但 它 无 法 从 键盘 中 获得 剩 下 的 签名 。 最 佳 的 做 法 是 : RES, HE 
所 需 的 声明 。 和 希望 在 你 疝 读本 书 的 时 候 ， 这 个 问题 已 经 修复 了 。 


enum CellType: String { 


case Basic = "Basic Game Cell" 
case Tall = "Tall Game Cell" 
case Fancy = "Fancy Game Cell" 


let gameCellType = CellType.Basic 


func tableView(tableView: UITableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UITableViewCell { 
// 


let cell = tableView.dequeueReusableCellWithIdentifier ( 
gameCellType. rawValue) 
as! UITableViewCell 

let passer = self.detaillItem! 

let game = arrangedGames! [indexPath.row] 


switch gameCellType { 
case .Basic: 
let playedStr = 
shortDateFormatter.stringFromDate (game.whenPlayed! ) 
let ratingStr = 
ratingFormatter.stringFromNumber (game.passerRating) ! 
let content = 
"vs \(game.theirTeam) \(playedStr) - \(ratingStr)" 
cell.textLabel?.text = content 


case .Tall: 


// 


case .Fancy: 


// 


return cell 


全 注意 不 章 中 ， 我 将 会 介绍 game 单 元 格 布局 中 的 3 个 变量 。 当 前 使 用 的 变量 由 gameCell Type 实例 选择 ， 根 据 需求 是 
在 .Basic，.Tall 或 者 .Fancy.tableView (_,cellForRowAtIndexPath:) 之 间 切 换 初 始 化 每 个 单元 格 类 型 。 之 后 ， 当 我 们 遇 到 其 他 变量 ， 


我 将 会 只 展示 新 代码 (基本 上 就 是 case 语 句 中 的 代码 ) ， 剩 下 的 部 分 将 会 保持 一 致 。Main.stotyboatd 中 的 表 包 含 每 个 变量 的 原型 。 
13.1.3 添加 Model-to-View 的 支持 


arrangedGames 是 GameListController 的 一 个 属性 ，GameListController 会 缓 仔 Passer 展 示 时 games 的 天 系 。 


Passer.gameArray 属 性 是 Games 的 一 个 数组 ， 它 继承 于 Passer 中 games 关 系 ， 按 照 时 间 顺 序 在 数据 中 存放 。 当 一 个 passer 
赋值 给 detailltem 的 时 候 ， 缓 仔 的 game list 惑 会 被 删除 ， 如 果 之 后 还 想 用 这 个 list， 那 么 使 用 arrangedGames 获 取 。 


var detailItem: Passer? { 
didSet { 
// Drop the game cache 
_arrangedGames = nil 


// Update the billboard. 

if billboard != nil { 
self .configureView () 

} 

// Update the table 

if tableView != nil { 
tableView!.reloadData () 


Ky 
// MARK: - Game cache 


Var arrangedGames: [Game]? { 
if let passer = detailItem { 
if _arrangedGames == nil { 
// The game array isn't known, and there's 
// a Passer to supply one. Get the array 
// and remember it. 
let gameSet = passer.games as NSSet 
let dateSort = NSSortDescriptor(key: "whenPlayed", 
ascending: true) 
_arrangedGames = 
gameSet.sortedArrayUsingDescriptors ([dateSort] ) 
as? [Game] 


} 
return _arrangedGames 


} 
// Games cache; reload if nil 
Var _arrangedGames: [Game]? = nil 


13.14 ”原型 元 到 


你 已 经 注意 到 UITableView 这 个 占 位 竺 已 经 被 标记 为 Table View/Prototype Content。Prototype 单 元 格 允 许 你 创建 并 在 
表 中 目 定 义 单元 格 布局 ; 当 UIKit 调 用 tableView(_,cellForRowAtindexPath:) 方 法 的 时 候 ， 残 是 在 让 表 初 始 化 一 个 元 素 。 


全 注意 如 果 一 个 独立 的 视图 中 有 自 定义 单元 格 ， 那 就 必须 要 自己 创建 单元 格 ， 为 这 个 单元 格 载 入 一 个 独立 的 NIB。 


在 组 件 库 (在 Utility 区 域 的 底部 ， 第 三 个 选项 卡 ) 中 搜索 cell， 找 到 Table View Cell， 然 后 将 它 拖 入 表 中 ， 现 在 这 个 表 已 经 
变 为 UlTableViewCell 原 型 的 实例 。 对 于 game 表 中 的 首 个 passer， 我 们 保持 一 个 简单 的 单行 格式 : 使 用 Attributes inspector 中 
的 Style 弹 出 窗口 ， 然 后 选择 Basic。 


在 tableView( ,cellForRowAtlndexPath:) 这 个 方法 中 ， 我 们 使 用 标识 符 Basic Game Cell 在 视图 中 查找 一 个 单元 格 。 在 
Identifier 区 域 输入 Basic Game Cell, 


我 们 还 没有 用 于 game 实 例 的 编辑 器 ， 现 在 开始 准备 : 在 Accessory 弹 出 窗口 中 选择 Detail， 把 一 个 圆圈 i 的 按钮 放 入 单元 格 
中 ， 这 个 按钮 将 会 指向 编辑 器 。 完 成 的 单元 格 看 起 来 应 该 如 图 13.1 所 示 。 


Prototype Cells 





图 13.1 简单 的 startet 元 素 的 prototype 用 于 展示 game table 


13.2 Game Table: 第 一 次 运行 


因为 马上 要 开始 运行 这 个 应 用 程序 ， 所 以 现在 回 到 code-editing (代码 编辑 ) 视图 。 


\ 一 一 一 一 


运行 它 ， 然 后 选择 一 个 passer。 到 现在 为 止 ,一切 顺利 。 表 中 的 单元 格 都 是 passer 参 加 的 每 场 比赛 。 细 市 按钮 正如 大 家 所 
料 。 字 符 捉 也 许 会 超过 表 元 素 的 宽度 ， 不 过 没 天 系 ， 这 只 是 一 个 看 看 表 能 人 否 正 常 工作 的 原型 (图 13.2) 。 
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vs Modesto Misanthropes 4/7/14... (i) 
vs Fremont Firebugs 4/14/14 - 41.9 G) 
vs Montgomery Music 4/21/14 -... (i) 
VS Spokane Stallions 4/26/74 - 3... (i) 


vs Richmond Roustabouts 5/5/1... (i) 


图 13.2 ”首次 运行 填充 表 元 素 的 新 机 制 


看 一 下 Debug 导 航 器 。 因 为 应 用 程序 并 没有 前 演 ， 所 以 stack trace 区 域 中 为 空 ， 但 是 导航 器 的 顶部 能 看 到 4 个 条 状 图 形 ， 标 
签 分 别 为 : CPU、Memory、Disk 和 Network (图 13.3) 。 


Xcode 总 是 与 Instruments 一 起 发 布 ， 它 是 一 款 复杂 的 工具 ， 按 照 事 件 的 方式 捕获 性 能 数据 并 将 它 按照 时 间 刻 度 显示 出 来 。 
这 是 一 个 非常 强大 的 调试 工具 ， 但 是 它 需 要 专门 的 构建 ， 以 及 一 些 设置 。 (在 工具 栏 的 Run 按 钮 上 按 住 鼠 标 不 动 ， 会 看 到 在 
Instruments 下 运行 应 用 程序 的 Profile 操 作 ) 。 
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图 13.3 Debug navigatot 顶 部 的 条 状 图 形 用 来 显示 应 用 程序 的 处 理 器 、 内 存 、 存 储 和 网 络 的 使 用 情况 。 单 击 图 形 上 面 的 圆 形 按钮 
可 以 控制 图 形 的 显 隐 


Ou 在 第 16 章 和 第 26 章 中 ， 你 将 会 学 习 到 更 多 关于 Instruments 的 内 容 。 


对 于 大 多 数 开发 者 来 说 ， 都 是 在 非常 特殊 的 情况 下 才 使 用 Instruments 分 析 应 用 程序 的 性 能 ， 特 殊 到 绝 大 多 数 开发 者 都 不 会 
运行 这 个 工具 ， 直 到 程序 出 现 明 显 的 性 能 问题 才 开 始 使 用 。 这 种 麻烦 都 是 因为 开 友 过 程 没有 注意 ， 导 致 性 能 问题 积累 而 引起 的 。 


还 有 一 个 原因 导致 性 能 问题 不 那么 明显 : iOS Simulator 并 不 是 一 个 模拟 器 ， 它 是 一 个 运行 于 硬件 上 层 的 OS X 应 用 程序 ， 它 
比 实际 的 设备 快 10 多 人 和信， 同时 还 有 大 量 近 于 无 限 的 内 存 。 在 实际 设备 上 非常 严重 的 问题 在 Simulator 上 可 能 都 无 法 察 党 。 


debug-time 图 形 对 性 能 问题 提供 了 持续 性 的 提醒 。 它 并 不 是 特别 精确 ， 但 是 你 能 看 出 大 概 趋势 。 即 使 应 用 程序 在 Mac 上 运 
行 时 并 没有 什么 问题 ， 图 标 上 面 的 数字 也 会 警告 你 实际 上 已 经 快要 达到 了 设备 的 极限 。 


在 这 种 情况 下 ， 唯 一 可 预见 的 CPU 消 耗 来 自 于 滑动 game 表 ， 因 为 这 个 时 候 App 会 执行 获取 新 数据 并 填充 数据 单元 格 的 操 
作 。 因 为 这 个 操作 的 频率 不 高 ， 所 以 CPU 的 消耗 也 不 明显 。 对 于 内 存 需 求 来 说 也 是 一 样 : 内 存 消 耗 随 着 数据 载 入 而 逐渐 增加 ， 
当 你 第 一 次 滚动 列表 、OS 填 充 数据 的 时 候 又 会 少量 增加 ， 但 是 在 我 的 例子 中 ， 它 基本 稳定 在 22MB。 在 1GB 的 机 器 上 ， 这 算 不 
了 什么 ， 现 在 还 不 用 担心 。 


全 注意 在 图 13.3 中 ， 你 会 发 现 内 存 使 用 有 一 段 时 间 几 乎 降 到 了 0， 当 滚动 game 表 的 时 候 ， 内 存 消 耗 才 重 新 增长 (与 此 同 
时 ，CPU 的 使 用 也 在 增加 ) 。 很 明显 ， 当 应 用 程序 空闲 的 时 候 ，OS X 庶 拟 内 存 系 统 将 比赛 数据 交换 到 了 硬盘 上 ， 当 再 次 使 用 应 
用 程序 的 时 候 ， 又 会 将 数据 存 回 内 存 。 


13.3” 目 定义 表格 里 元 格 


表 默 认 的 单元 格 几乎 没有 为 games 信 息 留 下 任何 空间 。 如 果 你 想 要 看 到 目 己 的 数据 ， 你 残 要 制作 一 个 属于 目 己 的 单元 格 。 


新 表单 元 格调 用 game 表 中 的 新 原型 单元 格 。 将 新 UITableViewCell 从 Object 库 拖 入 表 中 。 这 次 与 UIKit 标 准 的 单元 格 不 同 ， 
所 以 我 们 将 Style 弹 出 窗口 设置 为 Custom， 标 识 符 设置 为 Tall Game Cell, 


原型 单元 格 与 其 他 视图 类 似 ， 将 视图 拖 到 单元 格 中 ， 然 后 根据 需要 目 定 义 。 这 是 一 个 标准 大 小 的 table-view 单 元 格 ， 与 表 同 
宽 ，44 points (可 触摸 对 象 推荐 的 最 小 高 度 ) 。 这 个 大 小 并 不 能 容纳 我 们 想 要 填充 的 内 容 ， 我 们 需要 一 个 目 定 义 的 单元 格 ， 
所 以 拖 搜 单 元 格 的 上 边界 或 者 下 边界 (或 者 使 用 Size inspector， 第 五 个 选项 卡 ) 让 它 更 大 一 些 。 我 的 经 验 是 让 单元 格 的 高 度 为 
85 points, 


现在 ， 你 将 要 做 与 第 11 章 passer-detail 视 图 类 似 的 工作 。 记 住 将 Accessory 视 图 设置 为 Detail。 


- 将 game tating 的 标签 变 大 ， 文 本 填充 为 158.3 (tating 的 最 大 值 ) ， 系 统 黑 体 ，30 points， 蓝 色 ， 靠 左 对 齐 。 将 它 放 在 左上 
角 。 一 开始 的 标签 太 小 ， 无 法 完全 显示 其 内 容 ， 拖 动 重 新 调整 大 小 的 把 手 将 它 拖 动 到 足够 大 。 使 用 上品 -| 弹出 窗口 将 它 上 面 和 左 
侧 的 距离 都 设置 为 8 points， 锁 定 宽度 和 高 度 。 

(加 注意 ”对 于 leading 和 trailing 边 的 间隔 ，| 口 -| 弹出 窗口 将 会 提供 Constrain to margins， 对 于 父 视图 来 说 这 是 一 个 标准 的 插 


入 。 在 本 例 中 ， 不 需要 匀 选 这 个 选项 。 
- 右上 角 是 显示 teams、scotes 以 及 match 日 期 的 标签 。 在 其 中 填写 内 容 : 


Tacoma Touchdown-Scorers 88 
Tacoma Touchdown-Scorers 88 
12/12/12 


使 用 Lines 调 节 器 / 栏 将 标签 改 为 3 行 ， 输 入 多 行文 本 最 简单 的 方法 就 是 使 用 Text 栏 ， 然 后 在 行 切换 的 时 候 使 用 Option- 
Return ( 按 住 option 的 同时 按 下 return 键 ) ， 将 内 容 的 属性 更 改 为 System Italic, 10 points， 靠 右 对 齐 。 使 用 Hod 弹出 窗口 固 
定 它 的 大 小 ， 距 顶部 8 points， 左 边 8 points。 


. 底部 的 标签 为 14 points， 靠 左 对 齐 。 大 小 为 : 999/999-999YD - 99TD 一 99INT， 与 之 前 一 样 ， 使 用 O7 将 它 国定 在 下 


做 完 这 一 切 的 时 候 ， 你 应 该 能 看 到 如 图 13.4 所 示 的 效果 。 
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图 13.4 完成 的 game-list 单 元 格 布局 
Sis 我 也 在 标签 上 添加 了 Auto Layout 约 束 ， 但 是 在 这 里 不 再 重复 这 个 过 程 。 


如 何 将 单元 格 连 接 到 GameListController? 对 于 passer-detail 视 图 来 说 ， 之 前 使 用 @IBOutlets 连 接 ， 但 是 控制 器 同一 时 间 
只 能 管理 一 个 视图 。 对 于 game 单 元 格 来 说 ， 它 将 会 多 次 重新 载 入 原型 单元 格 。 并 不 会 有 一 个 单独 的 outlet 用 于 单元 格 或 者 它 的 


标签 。 任 何 时 候 控制 器 所 拥有 的 融 是 一 个 指向 它 正 在 操作 的 单元 格 指针 。 它 可 以 将 指针 指向 标签 。 


为 标签 设置 tag 可 以 完成 这 个 工作 。 每 个 UIView 一 一 包括 元 素 和 标签 一 一 都 有 一 个 与 之 相关 联 的 整数 。 如 果 这 个 tag 唯 一 ， 
那么 就 能 通过 在 包含 这 个 视图 的 父 视图 中 使 用 viewWithTag() 获 得 这 个 视图 。 


默认 情况 下 ，tag 为 0。 使 用 Attributes inspector 将 rating 标 签 的 tag 设 置 为 1， 将 scoring 标 签 的 tag 设 置 为 2，statistics 标 签 
设置 为 3。 在 inspector 的 View 部 分 找到 Tag 区 域 。 


最 后 ， 选 中 单元 格 ， 显 示 出 Size inspector。 注 意 高 度 的 数值 (本 例 中 是 85 points) 。UITableView 通 常 不 会 测量 它 显 示 的 
行 数 ， 所 有 的 行 数 高 度 都 相同 ， 默 认 情 况 下 是 44 points。 在 GameListController 场 景 中 选中 game 表 。 表 对 应 的 Size inspector 
最 顶部 会 显示 一 个 Table View Size。 将 Row Height 的 值 设 置 为 单元 素 的 高 度 (85) 。 基 本 的 单元 格 也 会 变 为 85 points， 但 是 
这 无 所 谓 。 


保存 所 做 的 更 改 ， 然 后 提交 。 


现在 ， 修 改 GameListController.swift 中 的 tableView(celIForRowAtlndexPath:): 每 当 需 要 刷新 的 时 候 ， 它 就 会 载 入 经 过 
编译 的 GameTableCell NIB。 这 个 方法 就 会 找到 对 应 的 标签 ， 并 将 格式 化 的 game 数 据 填 入 其 中 。 


let gameCellType = CellType.Tall 


enum TallCellTag: Int { 
case RatingLabel = 1 
case ScoreLabel = 2 
case StatsLabel = 3 
// More on this later: 
case ReactionImage = 4 


func tableView(tableView: UITableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UITableViewCell { 
// Internal function to translate between the label enum 
// and the actual UILabel for which it stands. 
func labelWithTag(tag: TallCellTag) -> UILabel 
{ return cell.viewWithTag(tag.rawValue) as! UILabel! } 


EE aps 
switch gameCellType { 
case .Basic: 


TE sii 


case .Tall: 
labelWithTag(.RatingLabel).text = 


ratingFormatter.stringFromNumber (game.passerRating) ! 


labelWithTag(.ScoreLabel).text = 
"\ (game.ourTeam) \(game.ourScore!)\n" + 
"\ (game.theirTeam) \(game.theirScore!)\n" + 
shortDateFormatter.stringFromDate (game.whenPlayed! ) 


labelWithTag(.StatsLabel).text = 
"\ (game.completions!)/\(game.attempts!) - " + 
"\(game.yards!) yd - \(game.touchdowns!) TD - " + 
"\ (game.interceptions!) INT" 
case .Fancy: 
TT es 
} 
return cell 


} 


再 次 运行 Passer Rating。 当 你 单 击 一 个 passer 的 时 候 ， 融 会 显示 出 对 应 的 完整 记录 ， 包 括 每 场 比赛 完整 的 统计 数据 。 应 用 
程序 显示 部 分 的 行为 与 我 们 的 预期 一 致 ， 如 图 13.5 所 示 。 


Carrier F 7:08 PM =. 
< Passers William Harrison 


William Harrison 
Attempts 3994 


Completions 1484 





Yards 12192 


Huntington 
Touchdowns 73 Beach Harriers 


Interceptions 126 3/24/14 = 6/21/21 
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A135 ”基于 文本 的 自 定 义 单 元 格 会 用 一 种 可 读 的 形式 显示 各 个 场次 比赛 的 完整 信息 


Og tagged-label 方 法 在 这 个 简单 的 例子 中 运行 得 很 好 。 不 过 ， 如 果 你 需要 更 复杂 的 信息 一 一 更 复杂 的 数据 或 者 自 定 义 
绘制 tagged 子 视图 提供 的 功能 并 不 够 。 你 需要 创建 一 个 新 的 UITalbeViewCell 子 类 。 这 个 子 类 中 有 所 包含 标签 的 outlet， 并 会 暴 
露出 用 于 接受 Game 对 象 作 为 显示 对 象 的 @ptopetty。 设 置 Game 会 让 自 定 义 的 单元 格 类 从 中 填充 所 包含 标签 的 数据 。tableView(- 
,cellForRowAtIndexPath:) 用 于 设置 game 必 性， 无 需 操 心 单元 格 视 图 的 细节 。 





13.4” 江 加 一 些 图 形 


我 还 不 满意 。 足 球 是 一 项 感性 的 运动 ， 它 的 粉丝 经 常会 翡 喜 交加 ，game list 应 该 能 反映 出 这 一 点 。 每 一 行 中 都 应 该 有 一 个 
图 形 用 来 衡量 passer 的 表现 。 


13.4.1 带 有 图 片 的 单元 格 


这 是 另外 一 种 目 定 义 的 单元 格 。 插 运 的 是 ， 少 量 的 修改 之 前 单元 格 融会 区 为 这 种 单元 格 。 在 Interface Builder 中 选中 目 定 义 
game 单 元 格 ， 复 制 (使 用 Edit 一 Duplicate， 上 号 D， 不 要 选择 File 菜 单 下 的 
Duplicatehttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/...) 。 


1) 在 Attributes inspector 中 ， 将 新 单元 格 的 Identifier 更 改 为 Fancy Game Cell, 
2) 重新 调整 元 素 的 高 度 为 96 points， 这 也 会 更 改 table 的 整体 高 度 。 
3) 统计 摘要 标签 更 改 为 两 行 ， 然 后 按 住 option 键 的 同时 按 下 return 可 以 将 yd 和 数字 的 TD 分 为 两 行 。 


4) 在 Object 库 中 搜索 Image， 会 显示 出 一 个 图 形 视 图 (UllmageView) ， 将 它 拖 到 左下 和 角 的 元 素 中 ， 然 后 将 其 更 改 为 
30x 30 像 素 。 


5) 添加 约束 ， 将 按钮 的 边界 放置 在 单元 格 边界 以 上 8 points 的 位 置 ， 将 它 的 leading 边 界 与 rating 标 签 对齐 ， 然 后 将 高 度 和 
EIZA. 


6) 将 image 视 图 的 tag 设 置 为 4。 


结果 应 该 如 图 13.6 所 示 。 
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图 13.6 ”game 单 元 格 最 后 一 次 迭代 将 一 个 UIImageView 添 加 到 左下 和 角 


13.4.2 将 Image 视 图 与 图 片 联 系 在 一 起 


为 此 ， 不 得 不 结束 tableView (-,cellForRowAtlndexPath:) (节选 ) : 
let gameCellType = CellType.Fancy 


i 


func tableView(tableView: UITableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UITableViewCell { 
// func labelWithTag(), cell, passer, game... 


switch gameCellType { 
case .Basic: 


ie mi 


case .Tall: 


ff wes 


case .Fancy: 
labelWithTag(.RatingLabel).text = 
ratingFormatter.stringFromNumber (game.passerRating) ! 


labelWithTag(.ScoreLabel).text = 
"\ (game.ourTeam) \(game.ourScore!)\n" + 
"\ (game.theirTeam) \(game.theirScore!)\n" + 
shortDateFormatter.stringFromDate (game.whenPlayed! ) 


labelWithTag(.StatsLabel).text = 
"\ (game.completions!)/\(game.attempts!) - " + 
"\ (game.yards!) yd\n\(game.touchdowns!) TD - " + 
"\ (game.interceptions!) INT" 


let reactionView = cell.viewWithTag (TallCellTag.ReactionImage 
. rawValue) 
as! ULImageView 

// Fetch the reaction image for the rating 
let reactionImage = (game.passerRating < 122.0) ? 

UIImage (named: "Despondent") : 

UlImage (named: "Elated") 
// Set the image. 
reactionView.image = reactionImage; 


return cell 


13.4.3 ”Assets 目录 
现在 还 差 图 片 本 身 。 我 制作 了 一 些 标记 图 片 (PNG， 带 有 透明 度 ) ， 还 生成 了 固定 分 辨 率 和 双 分 辨 率 (60x60 像 素 ) 版 本 
(在 示例 代码 的 icons 与 images 文 件 夹 中 能 找到 这 些 图 片 ) 。 


@ Despondent.png - 30 x 30 pixels 
@ Despondent@2x.png - 60 x 60 pixels 
@ Elated.png - 30 x 30 pixels 


© Elated@2x.png - 60 x 60 pixels 
Oe 如 果 可 以 ， 先 在 矢量 绘制 应 用 程序 中 简单 制作 一 些 图 片 ， 然 后 再 按照 固定 分 辩 窑 和 双 分 辩 率 缩放 图 片 大 小 。 
Image Sets 


在 Xcode 5 之 前 ， 如 果 要 在 应 用 程序 中 包含 图 片 ， 只 需要 简单 地 将 图 片 拖 入 Project 导 舰 器 中 ， 然 后 像 平 单一 样 决定 是 否 要 
复制 它们 ， 选 择 所 属 的 target 以 及 它 在 组 层级 机 构 中 的 位 置 。 保 持 严 格 的 层级 天 系 ， 在 导航 器 中 为 每 个 功能 组 都 创建 它 目 己 的 文 
件 夹 ， 这 样 束 能 知道 各 种 图 片 的 用 途 ， 让 图 片 在 我 们 的 控制 之 中 。 


并 非 所 有 人 都 会 这 样 做 。 我 见 过 很 多 项 目 因为 添加 、 著 换 或 者 删除 图 片 ， 导 致 项 目 导 舰 器 中 出 现 大 量 分 散 的 .png。 整 理 这 
些 散 雁 的 文件 很 困难 ， 因 为 无 法 确定 哪些 文件 有 用 ， 哪 些 没 用 。 


现在 已 经 不 存在 这 种 问题 。 你 无 需 在 Project 导 航 器 中 保持 对 图 片 的 引用 。 当 你 创建 了 一 个 新 的 1OS application targe 时 ， 


模板 中 就 已 经 包含 了 asset 目 录 ， 这 个 目录 的 后 级 为 .xcassets。 在 Project 导 航 器 中 看 起 来 像 一 个 文件 夹 ， 但 是 在 导航 器 中 并 没有 
展开 。 而 是 选中 Image.xcassets 之 后 ， 会 开打 一 个 目录 编辑 器 。 


资源 目录 包括 image sets (HKR) ， 理 论 上 图 片 集中 包含 各 种 单独 的 图 片 ， 根 据 分 辩 率 和 其 要 显示 的 设备 调整 。Image 
sets 中 的 图 片 能 根据 集合 的 名 字 获 得 。UIKit 能 根据 需要 显示 合适 的 图 片 ， 而 不 用 你 指定 。 


image sets 在 Project 导 航 器 外 保存 了 很 多 图 片 ， 并 且 根 据 功 能 自动 将 其 分 组 。 当 你 需要 蔡 换 一 个 image 的 时 候 ， 只 需要 在 
一 个 地 方 执行 相应 操作 ， 目 录 编 辑 器 会 帮助 你 清除 已 废除 的 图 片 。 


默认 情况 下 ， 目 录 中 包含 用 于 应 用 程序 图 标的 Applcon 人 集合。 如 果 想 让 你 的 App 在 iOSs 7 或 者 更 时 的 版 本 上 运行 ， 还 需要 提 
供 Launchlmage 和 集合 ， 里 面包 含 应 用 程序 启动 时 需要 显示 的 静态 图 片 。 


号 注意 OS X 应 用 程序 也 能 将 它 的 图 片 保存 在 资源 目录 中 。 


编辑 器 划分 成 了 Set list， 左 侧 是 图 片 集 列表 ， 然 后 是 Set viewer 和 主 视图 。 从 源 列 表 中 选择 一 个 集合 ，Set 查 看 器 中 束 会 显 
示 这 个 集合 的 缩 略 图 。 Utility 区 域 为 每 张 图 片 和 图 片 集 都 增加 了 Attributes inspector (第 三 个 选项 卡 ) 。 


13.4.4 [Assets Catalog 中 添加 图 卢 


将 6 张 图 片 拖 入 资源 目录 中 的 Set 列 表 中 ， 这 样 残 完 成 了 品 资 源 目 录 中 添加 图 片 的 操作 。Xcode 将 会 根据 图 片 名 称 和 实际 图 片 
的 大 小 推测 集合 分 组 和 分 辨 率 ( 见 图 13.7) 。 


[B Passer Rating Pass...1ing Images xcassets Despondent | ¢ > 


Apoloon Image Set 


Despondent 
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图 137 “将 单 分 辩 素 、 双 分 辩 素 和 三 分 辩 率 的 图 片 拖 到 资源 目录 的 Set 列 表 中 ， 并 将 它们 在 图 片 集中 按照 名 称 排序 ， 在 各 个 集合 中 
显示 各 自 的 缩 略图 。 当 UIKit 显 示 它 们 的 时 候 ， 设 置 Render As Template Image， 在 着 色 之 前 准备 图 片 


tableView (-,cellForRowAtindexPath:) 中 的 新 代码 已 经 使 用 Ullmage (named:) 方法 通过 名 字 从 资源 目录 中 获取 图 
片 。 再 次 运行 Passer Rating， 构 建 过 程 会 将 目录 编译 成 一 个 单独 的 二 进 制 文件 ， 这 样 UIKit 就 能 更 有 效 地 利用 它 (在 面向 iOS 6.0 
或 者 更 早 版 本 的 项 目 中 ， 你 还 可 以 在 项 目 中 使 用 资源 目录 。 为 了 兼容 ， 没 有 编译 目录 ， 它 们 的 内 容 会 在 applicationbundle 中 独 
WF) 。 


注意 当 Xcode 6 第 一 次 打开 老 项 目的 时 候 ， 它 就 会 添加 一 个 assetrcatalog 文 件 。 这 不 会 有 任何 危害 不 用 非 要 使 用 这 个 
文件 夹 不 过 Target editor 中 的 General 选 项 卡 将 会 帮助 你 把 图 标 和 启动 图 片 放 入 这 个 目录 中 。 这 不 但 没有 任何 害处 ， 还 是 一 个 
非常 好 的 想法 。 








选中 一 个 passer， 然 后 滚动 game 列 表 。Passer 获 得 了 122 及 以 上 评分 的 game 都 会 市 有 一 个 笑脸 ; 成 绩 不 大 好 的 game 都 会 
有 一 个 器 脸 ， 见 图 13.8。 
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图 13.8 ”game 单 元 格 的 最 终 形 态 ， 它 包含 passefr 在 game 中 表现 的 评分 图 片 


号 注意 UIImage 提 供 了 一 个 处 理 可 调整 图 片 大 小 的 极其 有 用 的 工具 。 考 虑 OS X 对 话 框 中 的 一 个 按钮 。 这 个 按钮 的 形状 和 
背景 都 由 一 个 模板 图 片 提供 。 这 个 模板 仅仅 带 有 左 项 端 〈 带 有 圆 角 ) ， 一 像素 宽 的 列 用 来 表示 如 何 为 这 个 按钮 的 主体 上 色 ， 还 有 


右 顶 端 。 


应 用 -[UIImageresizeableImageWithCaplInsets: ] 到 模板 中 ， 生 成 一 个 特殊 的 UIImage， 当 泻 染 一 个 更 宽 的 方形 时 ， 拉 伸 中 间 这 一 
像素 ， 使 之 填 满 左 顶 端 和 右 顶 端 之 间 的 空间 。Image Set 编 辑 器 能 让 你 将 一 个 托管 图 片 分 割 成 3 块 或 者 9 块 。 选 择 Editor 一 Show 


Slicing 就 能 看 到 这 个 功能 。 本 书 中 没有 充足 的 章节 完整 地 讲述 这 些 内 容 , 但 是 这 些 内 容 值 得 你 深入 了 解 。 


13.45 ”图 标 和 启动 图 片 


现在 我 们 已 经 完成 了 很 多 工作 ， 是 时 候 设 置 图 标 和 启动 图 片 了 (如 果 你 需要 应 用 程序 运行 在 iOS 7 或 者 更 早 的 版 本 上 ) 。 在 
资源 目录 中 ， 选 中 Applcon 图 片 集 。 如 果 你 之 前 做 过 iOS 应 用 程序 图 标 相关 的 工作 ， 那 么 现在 将 会 大 吃 一 惊 : 这 个 集合 中 仪 有 用 
于 iPhone Spotlight, Setting (29 points 或 者 98 像素) ， 以 及 用 户主 界面 应 用 程序 图 标的 双 分 辨 率 和 三 分 辨 率 的 图 片 。 


"iPhone” 和 “iOS 7，8 ”的 重复 是 一 个 线索 : Passer Rating 是 一 个 仅仅 针对 iO9s 8 版 本 的 iPhone 应 用 程序 。 图 标 集合 的 
Attributes inspector 中 有 选择 iPhone 和 iPad 从 iOS 6 到 iOS 8 的 复 选 框 。 还 有 一 个 复 选 框 是 M ac 图 标 。 


标 有 iOS icon is pre-rendered 的 复 选 框 是 设置 App 中 Info.plist 的 一 种 便捷 方式 ， 它 能 告诉 iOS 这 种 “华丽 的 ”效果 无 法 应 
用 于 iOS 6 或 者 之 前 的 版 本 。 


增加 对 iPhone iOS 6 的 支持 需要 额外 3 个 图 标 ， 分 别 应 用 于 两 种 分 辨 率 的 小 应 用 程序 图 标 和 单 分 辨 率 的 Spotlight/Settings 
图 标 。 


Ss 注意 图 标的 参数 中 都 是 以 point 为 单位 的 ， 而 不 是 以 pixel 为 单位 。 在 iOS 7Z Fy, iPhone application icon A 57 point, 
标签 的 内 容 就 会 根据 它 来 显示 。 在 单 分 辨 率 中 就 是 57 pixel， 但 是 在 2x 中 ， 就 是 114 pixel; 以 此 类 推 到 3x 图 片 。 你 需要 自己 做 相应 
的 计算 。 

勾 选 所 有 的 iOS3 复 选 枉 ， 为 了 让 每 种 图 标 风 格 都 能 满足 两 种 操作 系统 的 两 种 设备 ， 你 需要 提供 16 个 图 标 图 片 。 如 果 你 已 经 
成 了 一 个 Mac 图 标 ， 那 么 需要 提供 10 个 。 

QS ”图片 集 编辑 器 中 有 一 个 长 期 存在 的 问题 ， 图 标 位 置 移动 到 了 编辑 器 画布 的 左 侧 。 通 过 隐藏 边栏 导航 器 和 减少 集合 
列表 的 宽度 能 解决 这 个 问题 。 

不 用 抓 竹 ， 我 们 只 需要 选择 iPhone/iOs 7 和 8 这 个 选项 。 这 只 需要 3 个 图 标 ，2x 的 两 个 和 3x。 我 已 经 绘制 了 Passer Rating 所 
需 的 6 种 大 小 的 图 标 ， 然 后 将 每 个 图 片 放 入 对 应 的 位 置 中 ， 这 样 融 大 功 竺 成 ( 见 图 13.9) 。 
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13.9 +a Attribute inspector 中 的 复 选 框 中 仅 限制 了 运行 OS 7 和 iOS 8 的 iPhone， 那 么 6 张 图 片 就 能 满足 应 用 程序 图 标的 需求 


如 果 你 无 法 使 用 应 用 程序 模板 提供 的 XIB 或 者 storyboard， 那 就 需要 启动 图 片 (后 面 我 会 介绍 你 为 什么 要 提供 
XIB/storyboard) 。 假 设 应 用 程序 现在 没有 运行 ， 当 用 户 单 击 主 界面 上 应 用 程序 的 图 标 ， 应 用 程序 残 会 局 动 。 局 动 过 程 包括 应 
用 程序 什么 时 候 做 好 了 响应 用 户 操 作 的 准备 。 在 应 用 程序 能 正常 使 用 之 前 ，OS 和 应 用 程序 都 需要 做 一 些 工作 。 这 个 过 程 将 会 花 
费 一 些 时 间 ， 从 2007 年 开始 这 个 过 程 就 比较 长 了 。 


Apple 为 了 解决 这 个 问题 ， 使 用 了 一 个 小 技巧 。 在 应 用 程序 开始 运行 之 前 ，iOSs 会 从 应 用 程序 包 中 读 取 一 张 launch 
image (启动 图 片 ， 或 者 是 启动 界面 XIB 或 者 storyboard) ， 并 将 它 显示 在 屏幕 上 ， 直 到 能 够 显示 应 用 程序 的 第 一 个 界面 并 能 相 
应 用 户 操作 为 止 。 这 是 一 个 用 户 体验 方面 的 小 技巧 : 向 用 户 展示 一 些 类 似 于 应 用 程序 主 界面 的 内 容 ， 告 诉 用 户 想 要 运行 的 应 用 程 
序 正在 启动 ， 同 时 给 用 户 留 下 一 种 应 用 程序 启动 很 快 的 印象 。 


wits 它 不 是 splash scteen。 真 正 的 splash screen 会 在 一 段 时 间 内 阻止 用 户 访问 数据 。 一 旦 应 用 程序 能 够 正常 使 用 ，launch 
image (AXIB) 就 会 消失 。 理 想 情 况 下 ， 按 下 应 用 程序 图 标 与 应 用 程序 能 够 使 用 中 间 的 间隔 应 该 为 替 ， 根 本 就 不 会 看 到 launch 
image。 在 第 16 章 中 我 们 将 会 测试 这 种 理想 的 情况 。 


启动 图 片 是 基于 这 种 情况 才 出 现 的 ， 所 以 我 会 先 介 绍 它 。 


选中 Launchlmage 图 片 集合 。 在 Attributes inspector 中 ， 将 所 有 的 iPhone 各 种 尺寸 针对 iOS 8 及 之 后 、iOS 7 及 之 后 、and 
iOS 6 及 之 前 的 朝向 都 设置 为 Portrait， 无 论 是 否 包含 状态 栏 (对 于 商业 产品 ， 我 们 为 IOS 8 添加 了 一 张 横向 的 图 片 ) 。 
Attributes inspectorAiPad (SARASA) 提供 了 很 多 选项 ， 同 样 ， 对 iOS 6 或 者 更 早 的 版 本 也 提供 了 很 多 选项 (BARE 
iPad 的 图 片 ) 。 


考虑 到 iOS 6 支持 的 单 分 辨 率 变量 ， 它 有 20 张 可 能 的 图 片 (状态 栏 变量 意味 着 实际 上 最 大 应 该 有 18 张 图 片 ) 。 你 开始 渴望 看 
到 局 动 XIB。 


回 退 一 步 ， 取 消 选择 所 有 的 选项 除了 针对 iOS 7 和 iOS 8 的 iPhone Portrait 朝 向 ， 谢 天 谢 地 : 只 有 4 张 图 片 。 我 使 用 
File 一 Save Screen Shot (¢6S) 命令 捕获 passer-list 屏 幕 快照 。 使 用 我 最 喜欢 的 图 形 编辑 器 去 除 所 有 文本 。 启 动 图 片 不 应 该 有 
任何 看 起 来 像 数 据 或 者 地 点 的 信息 。 对 于 所 有 地 域 来 说 ， 只 应 该 有 一 个 启动 图 片 集 。 从 瑞 语 语言 的 按钮 的 图 片 到 本 地 语言 按钮 的 
转换 十 分 平缓 。 但 是 如 果 你 正在 使 用 德语 操作 系统 ， 将 外 国文 本 蔡 换 成 本 地 文本 的 做 法 就 相当 可 笑 了 。 


StS 当 你 为 了 这 种 目的 保存 屏幕 快照 的 时 候 ， 确 保 iOS 模 拟 器 的 界面 是 完全 显示 : Window->Scale_>100% (%1) 。 


这 就 是 它 的 来 源 。iOS 8 引入 了 launch storyboards ( 它 包含 了 XIB) 。 你 可 以 为 一 个 单独 的 视图 提供 一 个 Interface Builder 
产品 ; 新 应 用 程序 异 板 为 你 提供 了 一 个 。 这 样 融会 给 系统 提供 一 毕 不 依赖 设备 界面 形状 或 者 分 辨 率 的 (大 屏 ， 三 分 辨 率 的 
iPhone 6 Plus 只 是 一 个 开始 ) 展示 内 容 。 若 不 提供 启动 布局 ，iOS 会 假设 你 的 应 用 程序 没有 为 现代 程序 尺寸 做 好 准备 ， 就 会 根 
据 屏幕 “缩放 ”应 用 程序 。 


如 果 storyboards 没 在 那里 (你 手 上 的 项 目 可 能 是 以 前 的 老 项 目 ) ， 那 就 创建 一 个 storyboard， 并 在 Target 编 辑 器 的 


General 选 项 卡 中 注册 它 的 基本 名 称 。 因 为 启动 文件 通过 Auto Layout 排 列 ， 使 用 了 大 小 分 类 ， 一 个 文件 完全 可 以 在 任何 屏幕 上 
显示 。 记 住 NIB (编译 过 的 XIB) 将 会 在 任何 代码 执行 之 前 绘制 ， 此 时 还 没有 视图 控制 器 。 它 仪 仪 用 来 显示 ， 这 只 是 使 用 一 个 文 
件 在 任何 iOS 界 面 上 显示 初始 化 屏幕 的 方法 。 


13.5 We 
ANE INA S Passer Rating 如 何 从 Passer 的 games 数 据 集中 获取 数据 ， 然 后 填充 game 表 。 本 章 还 介绍 了 storyboard 的 另外 
一 项 功能 ， 为 表 指定 一 个 原型 单元 格 。 我 们 经 历 了 3 个 阶段 : 
"iOS 提供 的 只 有 文本 的 简单 单元 格 ， 仅 仅 用 来 测试 填充 机 制 。 
. 带 有 自 定义 布局 的 单元 格 ， 用 来 展示 game 的 完整 信息 ， 信 息 的 格式 相当 紧凑 和 有 趣 (或 者 你 可 以 让 它 很 有 趣 ) 。 
. 开发 带 有 完整 信息 的 单元 格 ， 它 使 用 UIImageView 显 示 内 容 。 


添加 图 片 看 起 来 很 傻 ， 但 倍 助 它 能 彻底 弄 清楚 asset-catalog 的 功能 ，asset-catalog 能 让 iOS 应 用 程序 更 简单 地 管理 所 需 的 
F 


第 14 章 ”添加 编辑 器 


我 们 要 对 Passer Rating 做 最 后 一 件 实 质 性 更 改 : 为 passer 江 加 一 个 编辑 器 。 这 个 任务 本 身 很 容易 完成 一 一 你 知道 如 何 添加 
一 个 场景 ， 编 辑 器 的 概念 也 并 不 复杂 ， 但 是 它 能 让 我 们 更 深入 地 了 解 Storyboard。 


14.1 计划 


我 们 大 体 已 经 知道 了 要 做 什么 ， 在 第 8 草 中 布局 就 已 经 仓 企 了 。 它 是 一 个 模型 视图 (MRL) ， 包 含 一 个 表格 ， 表 格 
的 每 一 行 能 够 修改 passer 姓 、 名 以 及 当前 所 属 团队 名 字 。Save 和 Cancel 按 钮 能 让 用 户 按 照 所 选 的 方式 退出 编辑 器 。 


14.2 ”添加 模型 场景 


在 编辑 器 中 打开 Main.storyboard， 然 后 使 用 Editor 一 Canvas 一 Zoom 一 Zoom Out (#1) 命令 ， 腾 出 一 些 空间 来 放 新 
的 视图 。 在 Utility 区 域 (请 确保 选中 了 第 三 个 选项 卡 Object 库 ) 的 Library 部 分 找到 View Controller (UlViewController) ， 将 
它 拖 到 game-list 控 制 器 下 (引导 箭头 能 让 你 快速 找到 合适 的 位 置 ) 。 


Key Equivalents 


缩放 Interface Builder 画 布 命令 的 快捷 键 很 复杂 ， 在 美式 键盘 中 尤为 复杂 ， 所 以 不 推荐 使 用 。Zoom Out (+ 44{) Eb ( 


\t8[) 有 效率 得 多 ， 后 者 很 塌 钦 ， 因 为 一 开始 它 需 要 按 住 Shift 键 ， 所 以 速度 起 码 降低 了 一 半 。 


解决 方案 是 打开 Preference 窗 口中 的 Key Bindings 面 板 ， 在 搜索 栏 中 输入 Zoom。 包 含 Zoom 的 搜索 结果 有 很 多 ， 查 找 标记 为 
Editor Menu for Interface Builder (看 不 到 完整 的 描述 文本 ， 因 为 显示 描述 的 栏 无 法 调整 大 小 ) 的 命令 


第 二 栏 包含 每 个 命令 对 应 的 快捷 键 ， 单 击 其 中 一 个 单元 格 ， 你 按 下 的 任何 组 合 按键 都 会 赋值 给 菜单 项 。 修 改 完 后 单 击 其 他 位 
置 让 更 改 生效 。 我 为 Zoom to 100%、Zoom Out 和 Zoom In4§ Z 1 RIESE FY] ZH. VE. UH], 


这 些 快捷 键 可 能 (也 许 所 有 的 ) 会 与 其 他 命令 的 快捷 键 相 冲突 。 如 果 Xcode 将 这 个 快捷 键 标 记 为 黄色 ， 那 就 不 会 有 问题 ， 这 
说 明 两 条 命令 会 在 不 同 的 上 下 文中 起 作用 。 比 如 ， 调 武器 视图 和 Intetrface Buildetr， 上 下 文 决定 了 快捷 键 对 应 的 命令 是 什么 。 如 果 
这 个 快捷 键 被 标记 为 红色 ， 那 说 明 两 个 快捷 键 在 同一 个 上 下 文中 有 冲突 。 单 击 快捷 键 列表 中 的 Conflicts 过 滤器 显示 出 所 有 的 问 


题 ， 决 定 如 何 解 决 这 些 冲 突 。 
Key Bindings 选 项 卡 的 搜索 栏 左边 界 有 一 个 弹出 菜单 ， 它 能 让 你 通过 描述 或 者 快捷 键 过 滤 搜 索 结 果 


sits Apple 术 语 中 对 于 从 键盘 上 调用 一 个 命令 的 称呼 一 直 都 是 equivalents， 不 过 研究 表明 ， 用 户 无 法 理解 这 一 点 。 记 
住 ， 在 Mac 风 格 的 屏幕 菜单 中 ， 使 用 按键 组 合 加 上 移动 双手 的 输入 远 比 用 鼠标 在 菜单 中 点 击 慢 。 在 Mac 中 ， 这 种 按键 组 合并 不 是 
shortcuts (快捷 键 ) ， 使 用 按键 组 合 也 没有 提供 任何 加 速 。 没 有 人 相信 这 一 点 ， 但 是 这 个 术语 却 留 在 了 Cocoa UI 中 。 


选中 新 场景 和 Identity inspector (第 三 个 选项 卡 ，Utility 区 之 上 ) , AClass Passer EditController 命 名 。 牢 记 构 建 这 样 一 


| =。 


这 个 场景 由 两 部 分 组 成 : 上 面 是 工具 栏 ， 下 面 是 table。 不 小 心 束 会 使 用 UITableViewController 控 制 这 个 场景 ， 但 是 如 果 
你 真 的 这 么 做 了 ， 整 个 场景 必须 都 是 UITableView。 我 们 并 不 想 这 样 。 


相反 ， 我 们 也 不 想 将 UITableView 直 接 放 到 场景 中 。 为 了 制作 编辑 表单 ， 我 们 要 充分 利用 static table cell 的 优势 ， 没 有 
UlTableViewController 束 无 法 利用 这 项 功能 。 看 起 来 我 们 卡 在 了 这 里 


在 思考 如 何 解决 这 个 问题 的 时 候 ， 我 们 先 拖 入 一 个 UIToolbar， 将 它 放 在 场景 的 顶部 ， 让 它 缩放 到 百分之百 大 小 。 将 
leading 和 trailing 边 界 与 父 视图 的 约束 设置 为 0， 与 Top Layout Guide (界面 项 部 任何 工具 栏 下 面 的 虚线 一 一 在 你 将 top guide 
作为 一 个 选项 之 前 ， 你 可 能 不 得 不 让 视图 的 项 部 在 任何 顶部 工具 栏 之 下 ) 的 约束 也 设置 为 0。 


工具 栏 已 经 有 一 个 标签 为 tem 的 按钮 。 工 具 栏 不 包含 任何 垂直 布局 ， 并 且 它 们 有 自己 的 水 平 布局 : 将 一 个 Flexible Space 
Bar Button Item (对 ， 从 技术 上 讲 它 是 一 个 按钮 ， 但 是 实际 上 不 是 ) 放 到 这 个 按钮 的 右边 ， 再 将 另外 一 个 UIBarButtonltem 放 
在 它 右边 。 


现在 ， 你 已 经 有 了 两 个 标签 为 tem 的 按钮 。 有 的 时 候 需 要 故弄玄虚 ， 但 是 用 户 界 面 设计 不 能 这 样 做 。 选 中 左边 的 按钮 。 如 
果 它 是 一 个 UIButton ， 你 需要 在 Attributes inspector 中 编辑 Title 字 段 。Bar-button 有 所 不 同 ， 因 为 它们 经 常 都 带 有 标准 的 标题 
或 者 图 标 。 注 意 Attributes inspector 中 的 Bar Button Item 部 分 。 


- 将 Style 弹 出 窗 设置 为 Bordered。 在 按钮 周围 添加 一 个 边界 的 设计 方式 在 iOS 7 中 已 经 过 时 了 ， 但 是 由 于 历史 原因 这 个 名 称 还 
在 使 用 ， 如 果 你 在 iDS 6 上 运行 此 程序 ， 你 会 看 到 按钮 周围 深 灰 色 的 边框 。 


- 查看 Identifiet 选 项 。 首 先是 Custom， 这 个 选项 能 让 你 设置 标题 。 还 有 很 多 标准 的 按钮 类 型 。 其 中 一 些 按钮 对 应 一 些 图 标 
Stop 按 钮 有 一 个 大 大 的 十 字 一 一 还 有 一 些 用 字符 串 表 示 按 钮 的 作用 ， 比 如 Save。 哪 一 种 好 些 呢 ? iOS 将 acceptance 的 按钮 上 的 
字体 加 重 显示 ， 为 标题 是 系统 的 标准 组 成 部 分 ， 它 会 将 标题 名 称 根据 地 域 信息 自动 切换 。 在 Idehtifiet 下 拉 框 中 选择 Save 按 钮 。 





选中 工具 栏 左边 的 按钮 ， 将 identifietr 设 置 为 Cancel。 


这 些 按钮 都 有 各 目的 作用 ， 稍 后 融会 看 到 。 


工具 栏 没有 办 法 像 导 航 栏 那样 标准 自身 。 这 里 有 个 小 扩 巧 : 拖 入 一 个 UILabel， 将 标题 设置 为 Edit Passer， 然 后 设置 为 
System Bold，17。 选 中 这 个 标签 和 工具 栏 (无 法 将 标签 放 到 工具 栏 上 ) ， 然 后 使 用 对 齐 控件 将 它 与 外 层 视图 (1B 无 法 识别 工具 
的 子 视图 ) 保持 水 平 居中 对 齐 ， 同 时 使 用 定位 控件 将 它 与 项 边 保 持 固定 的 距离 。 标 签 内 容 将 会 从 标签 中 消失 ， 但 是 如 果 你 选择 
Resolve Auto Layout lssues 菜 单 ， 束 能 在 场景 中 重新 进行 布局 ， 标 签 中 的 文本 也 会 重新 完整 地 显示 出 来 。 


14.2.1 其 入 的 View Controller 


回顾 一 下 : 我 们 无 法 拥有 一 个 UlTableViewController， 因 为 我 们 需要 工具 栏 。 但 是 如 果 我 们 简单 地 使 用 UlTableView， 蒜 
无 法 使 用 能 为 我 们 带 来 极 大 便捷 的 static table cells, 


9S 注意 ”部 分 开发 者 可 能 会 像 处 理 其 他 场景 一 样 ， 将 编辑 器 放 到 相同 的 UINavigation Conttollet 链 中 ， 或 者 将 编辑 器 的 table- 
view 控 制 器 庶 入 一 个 新 增 的 导航 栏 控制 器 栈 中 。 我 会 向 你 展示 如 何 突破 navigation-controller 栈 但 却 还 能 拥有 控制 权 ， 以 及 如 何 做 到 


不 必 陷 入 这 样 的 困境 。 


所 以 我 们 使 用 UlTableViewController 和 我 们 的 工具 栏 ， 这 样 就 可 以 做 到 面面俱到 。 这 个 小 技巧 是 : 使 用 embedded view 
controller (内 入 的 视图 控制 器 ) ， 它 能 将 一 个 容器 分 着 ， 让 另外 一 个 控制 器 在 里 面 运行 。 


在 Library 面 板 底部 的 搜索 区 域 输入 contai， 找 到 Container View， 并 将 它 放 到 Passer Edit 场 景 中 。 现 在 看 起 来 不 太 好 ， 它 
太 小 了 ， 但 是 一 些 约束 会 自动 调整 它 的 大 小 “与 控制 器 的 底 边 、leading 和 右边 界 的 距离 设置 为 0， 与 工具 栏 底 部 的 边界 设置 为 
0) 。 


这 个 控制 器 看 起 来 需要 引入 另外 一 个 视图 控制 器 。 也 许 Interface Builder 不 太 方 便 放 置 它 ， 不 过 这 也 好 解决 。 缩 小 画布 ， 将 
一 个 子 场景 放 到 编辑 器 的 右边 。 你 会 友 现 新 的 scene 已 经 调整 了 自身 大 小 来 匹配 这 个 编辑 器 。 很 好 。 还 友 现 新 场景 已 经 给 自身 添 
加 了 一 个 UIViewController， 但 这 不 是 我 们 想 要 的 结果 ， 见 图 14.1。 


Passer Edit Controller 


Lancel 2:9: bode: Passapf ===: E 





图 14.1 视图 编辑 器 包含 它 自身 的 工具 栏 ， 还 有 一 个 用 于 放置 表 的 容器 ， 但 是 当 我 们 需要 一 个 UITableViewController 的 时 候 ， 控 


制 器 视图 添加 了 一 个 空 的 UIViewConttollet 


之 所 以 很 糟糕 的 原因 是 我 们 需要 一 个 UITableViewController， 它 是 UIViewController 的 一 个 子 类 ， 但 是 如 果 你 简单 地 将 已 
经 存在 的 控制 器 设置 为 这 个 类 ，1Interface Builder 无 法 正确 地 显示 用 来 构建 一 个 表 所 需要 的 工具 。 这 是 一 个 用 于 错误 控制 器 的 错 


误 场景 。 


我 们 需要 使 用 正确 的 控制 器 ， 找 到 Table View Controller 对 象 ， 然 后 将 它 拒 入 画布 中 。 这 样 Interface Builder 束 会 知道 ， 
这 是 一 个 单独 的 场景 ， 所 以 它 在 界面 上 显示 的 大 小 束 是 你 当前 storyboard 的 大 小 。 这 样 束 没有 问题 了 。 


将 编辑 器 场景 中 的 容器 视图 用 Control-drag ( 按 住 control 键 拖 动 ) 的 方式 拖 入 新 的 table-controller 场 景 ， 然 后 会 看 到 一 个 
提示 窗口 ， 在 这 个 窗口 中 可 以 选择 你 想 要 使 用 的 segue。 单 击 embed， 它 也 是 唯一 的 选项 。 容 器 仅 能 有 一 个 肉 入 的 控制 器 ， 所 
以 殴打 破 了 与 UIlViewController 互 锁 的 丛 入 segue。 选 中 它 的 场景 ， 然 后 按 delete 键 。 


选中 新 的 表 控 制 器 ， 使 用 Identity inspector 将 类 名 设置 为 PasserEditTableController。 这 样 做 很 麻烦 ， 但 是 其 他 开发 者 
(包括 一 个 月 后 你 自己 来 看 自己 的 代码 ) 需要 通过 类 名 来 分 辨 类 的 作用 。 


区 注 意 ” 生 成 带 有 连接 到 控制 器 上 的 连接 的 stotyboatd 仅 需 设 置 控制 器 的 名 称 。 有 的 时 候 也 不 需要 这 样 做 。 在 这 个 例子 中 你 
需要 设置 模块 的 名 称 ， 从 这 个 模块 中 找到 对 应 的 类 。 在 Identity inspectot 中 ， 将 Module 设 置 为 应 用 程序 的 主 模块 Passef_ Rating。 应 
用 程序 模块 会 将 名 称 中 的 数字 字母 下 划 线 替换 为 其 他 内 容 。 


Segues 应 该 始终 都 有 自己 的 名 称 ， 选 中 嵌入 的 segue， 然 后 使 用 Attributes inspector 将 ldentifier 设 置 为 如 Passer Edit 
Embed 这 样 的 名 称 。 
14.2.2 Passer List 与 Editor 相 连 

我 们 需要 一 种 方法 能 让 编辑 器 获得 passers 的 根 列 表 。 这 有 点 复杂 ， 不 过 仪 仅 是 一 点 ， 因 为 它 对 编辑 器 来 涡 有 两 种 用 途 : 一 
是 修改 已 经 仓 在 的 Passer 的 内 容 ， 还 有 一 点 是 添加 新 的 Passer。 

我 们 可 以 通过 Interface Builder 中 已 经 存在 的 Passer 完 成 大 部 分 功能 。 


自从 项 目 模 板 将 PasserListController.viewDidLoad(0 给 我 们 之 后 ， 它 就 没有 发 生 更 改 。 这 个 方法 的 部 分 功能 就 是 将 导航 栏 
条 目 右 边 的 按钮 设置 为 标准 的 Add 按 钮 。 我 们 需要 使 用 这 个 按钮 作为 segue 的 根 节点 。 


将 一 个 工具 栏 按钮 从 Library 中 拖 入 passer-list 控 制 器 场景 中 导航 工具 栏 的 右边 。 在 Attributes inspector 中 选中 标准 的 Add 
标识 符 。 按 下 control 键 并 拖 动 新 的 Add 按 钮 到 passer-editor 场 景 。 


局 注意 ”我 猜 编辑 器 场景 和 Add 按 钮 不 会 同时 都 能 恰好 放置 在 界面 的 适当 位 置 。 好 消息 是 : 虽然 你 无 法 对 画布 的 视图 做 太 


多 缩小 操作 ,但 是 你 可 以 拖 动 segues。 


你 会 看 到 一 个 segue 类 型 的 菜单 ， 选 择 Present Modally。 这 个 segue 会 因为 轻 击 accessory 而 触 友 ， 同 时 它 也 会 将 editor 按 


照 规定 的 方式 (从 Passer 列 表 的 底部 向 上 滑 ) 展示 出 来 。 
(> 注意 iPad 借 助 它 的 大 屏幕 ， 提 供 了 展示 模型 视图 的 其 他 方式 。 可 以 参考 modalPresentation Style 的 文档 。 


为 新 Segue 添 加 一 个 标识 符 : Edit passer。Segue 对 应 的 Attributes inspector 提 供 了 其 他 Transition 风 格 ， 不 要 异想天开 ， 
我 们 可 以 未 一 试 一 试 这 些 风 格 的 效果 。 


he 


Wit 它 是 一 个 Identifier， 而 不 是 一 个 编码 符号 ， 所 以 编译 器 不 会 告诉 你 这 个 标识 符 不 适合 人 类 阅读 。 


~ 


现在 要 编辑 已 经 存在 的 Passer。UlTableViewCells 会 在 一 行 的 右边 显示 以 下 5 种 标准 accessories 之 一 。 


- Disclosute， 朝 右 的 箭头 ， 表 示 轻 击 这 个 单元 格 就 会 打开 下 一 级 页 面 。 


Detail， 一 个 圆圈 中 间 有 个 i， 单 击 这 个 按钮 就 会 打开 单元 格 对 应 对 象 的 编辑 器 。 你 需要 轻 击 accessoty 本 身 来 打开 这 个 编辑 


器 〈 在 iDS 6 或 者 更 早 的 版 本 中 ， 这 个 图 标 是 一 个 蓝 色 圆圈 包含 一 个 V 形 图 案 ) 。 


- Detail Disclosure， 既 有 箭头 也 有 一 个 在 圆圈 中 的 1， 它 表 示 轻 击 这 个 按钮 就 能 显示 一 个 编辑 器 ， 而 轻 击 这 一 行 其 他 地 方 就 


会 进入 另外 一 个 界面 。 
. 一 个 对 多 。 
` 什么 都 没有 。 


passer 表 的 原型 单元 格 最 开始 是 disclosure accessory， 因 为 我 们 使 用 单元 格 显示 一 个 passer 的 记录 。 现 在 我 们 想 要 编辑 
passer 对 应 的 记录 ， 我 们 需要 一 个 detail-disclosure accessory。 在 Passer List Controller 表 中 选中 这 个 单元 格 ， 然 后 使 用 


Attributes inspector 将 Accessory 设 置 为 Detail Disclosure, 


Detail-disclosure accessory 是 一 个 按钮 ， 它 能 触 友 一 个 segue。 你 可 能 想 要 添加 一 个 额外 的 Segue 到 编辑 器 的 控制 器 。 这 
也 能 正常 工作 ， 但 是 会 有 一 个 问题 : 为 了 编辑 一 个 已 经 存在 的 passer，prepareForSeguee (-，sender:) 这 个 方法 需要 知道 它 
是 哪个 passer。 当 运行 到 这 个 方法 的 时 候 ， 那 个 信息 就 已 经 消失 了 ，accessory 单 击 事件 看 起 来 与 其 他 单 击 事件 无 异 。 


现在 ， 我 们 先 将 这 个 问题 放 在 一 边 。 
14.2.3 Static Table Cells 
ME, FulletallLARBaeA Passer Editor 场 景 的 表 来 构建 编辑 表格 。 放 大 场景 中 的 表 并 选中 。 你 需要 做 这 些 更 改 : 
将 Content 从 Dynamic Ptototypes 更 改 为 Static Cells. 


- 注意 到 Sections 被 设置 为 1， 这 正 是 我 们 想 要 的 结果 。 





- 将 Style 更 改 为 Grouped。Plain 风 格 非常 适用 于 分 段 数据 一 一 当 你 向 下 滑动 的 时 候 ， 它 也 会 将 段 头 显示 在 界面 上 一 一 但 是 分 


组 的 表 更 适合 于 静态 显示 。 
-Selection 应 该 为 No Selection. 


现在 移动 到 一 个 section。 为 了 选中 这 个 section， 方法 之 一 是 在 文档 大 纲 中 找到 这 个 section， 单 击 画 布 左 下 角 的 箭头 按钮 
就 能 展开 文档 大 纲 ; 方法 之 二 是 control-shift-clicking 场 景 中 的 section， 然 后 选中 这 个 section.。 


你 需要 做 两 个 更 改 : 将 Rows 设 置 为 1， 然 后 将 Header 设 置 为 Passer (1B 将 会 强制 改 为 大 写 ， 不 用 在 意 ) 。 这 个 表格 需要 3 
行 ， 如 果 将 一 行 设 计 好 ， 那 么 可 以 复制 它 两 次 ， 这 样 就 有 了 3 个 完全 相同 的 布局 。 


现在 深入 到 其 中 的 一 个 单元 格 中 。 将 一 个 标签 抱 入 其 中 (在 容器 中 垂直 居中 ， 固 定 leading margin; 不 指定 宽度 一 一 让 内 
置 的 文本 容器 确定 宽度 ) ， 然 后 将 标题 设置 为 First Name。 有 再 拖 入 一 个 UITextField， 将 它 放 在 celI 的 右 端 (固定 trailing 
edge， 宽 度 190 points， 优 移 级 为 751， 基 本 线 与 标签 对 齐 ， 标 签 的 leading 间 隅 要 大 于 或 者 等 于 4 points) 。 稍 微 向 下 滚动 
Attributes inspector， 找 到 用 于 设置 键盘 行为 的 弹出 菜单 。 将 Capitalization 设 置 为 Words ( 它 可 以 保持 合适 的 名 字 ) ， 然 后 将 
Correction 和 Spell Checking. 


再 次 选中 刚才 的 section， 将 它 设置 为 3 行 ， 惑 像 我 如 的 那样 ， 这 3 行 都 有 相同 的 布局 。 将 标题 分 别 设置 为 First Name, Last 


Name 及 Current Team。 为 了 更 简洁 ， 可 以 将 Placeholder Text 的 文本 域 设 置 为 First、Last 和 Team。 


14.3 ”编辑 器 视图 控制 器 


刚才 这 些 修改 涉及 的 代码 都 没有 实现 ， 现 在 我 们 需要 补 全 代码 。 


创建 刚才 设 定好 的 类 : PasserEditController (UIViewController 的 子 类 ) 和 PasserEditTable 
Controller (UlTableViewController 的 子 类 ) 。 


PasserListController 类 中 viewDidLoad0 方 法 的 最 后 两 个 语句 创建 了 一 个 用 于 passer 列 表 的 Add 按 钮 。 删 除 这 两 行 。 还 有 一 
个 没有 用 的 insertNewObject， 虽 然 它 也 没什么 影响 ， 但 是 为 了 不 分 散 我 们 的 注意 力 ， 还 是 将 它 删除 。 


14.3.1 编辑 器 表 


编辑 器 表 要 做 的 工作 不 多 。 它 必须 能 够 记录 文本 域 和 对 应 的 内 容 ， 同 时 也 要 接受 并 返回 编辑 域 中 的 字符 串 。 如 果 我 们 仔细 选 
择 文本 域 的 名 字 和 对 应 的 属性 ， 那 么 我 们 就 能 让 大 部 分 文本 域 与 Passer 属 性 之 间 的 传递 工作 自动 化 。Passer 值 是 firstName、 
lastName 和 currentTeam。 其 他 名 字 都 直接 或 者 间接 来 自 这 些 名 字 。 


现在 ,已 经 有 了 类 文件 ， 我 们 可 以 将 栏 位 链接 到 PasserEditTableController。 更 改 Interface Builder 的 选项 卡 显示 出 
Assistant editor， 然 后 将 跳 转 栏 的 第 一 段 设 置 为 Automatic， 同 时 i 上 Navigator 和 Utility area 设 置 为 隐藏 ， 这 样 残 能 得 到 较 大 
的 可 使 用 的 区 域 。 当 选中 场景 的 时 候 ，Assistant 会 显示 出 控制 器 的 源 文件 。 将 每 个 文本 域 按 住 control 键 拖 到 
PasserEditTableController.swift 中 PasserEditTableController 定 义 的 项 部 。 再 增加 一 个 var 属 性 ， 让 类 顶部 的 定义 看 起 来 如 下 
代码 所 示 : 

class PasserEditTableController: UITableViewController { 
@IBOutlet weak var firstNameField: UITextField! 


@TBOutlet weak var lastNameField: UITextField! 
@TBOutlet weak var currentTeamField: UITextField! 


weak var parent: PasserEditController! 


ie m 


控制 器 的 API 使 用 一 个 字典 来 传递 编辑 器 的 值 。 有 的 人 可 能 会 认为 ， 传 递 编辑 器 的 值 最 好 的 方法 是 调用 每 个 String 属 性 ， 但 
是 使 用 字典 传递 的 优势 在 于 从 APl 中 移 除数 据 结 构 ， 并 提供 了 一 种 传递 数据 的 方法 ， 而 不 用 管 这 个 数据 是 一 个 已 经 仓 在 的 记录 还 
是 全 新 的 记录 。 当 然 ， 还 有 Key-Value Coding (KVC) 方法 能 很 方便 地 获取 或 者 设置 字典 里 面 的 值 。 字 和 典 里 面 的 键 值 为 


firstName、|lastName 和 currentTeam。 


现在 ， 让 我 们 看 看 如 何 同 编辑 器 中 填 入 数据 和 如 何 从 其 中 获取 数据 : 


let propertyNames = ["firstName", "lastName", "currentTeam"] 
var values: [String:String] { 
get { 
var retval: [String:String] = [:] 


for name in propertyNames { 


let field = valueForKey("\(name)Field") as! UITextField 
retval [name] = field.text ?? "" 


} 


return retval 


} 
set { 


for name in propertyNames { 
let field = valueForKey("\(name)Field") as! UITextField 
field.text = newValue[name] ?? "" 


override func viewDidLoad() { 
super.viewDidLoad () 
// prepareForSegue comes before the view is populated with its 
// text fields. There are other ways to solve this, but in this 
// case, we call out to the wrapper view for the values now that 
// the table is ready for them. 
parent.childReadyForValues () 


LORS eae OR, PARAL AAE: 


class PasserEditController: UIViewController { 
override func prepareForSegue(segue: UIStoryboardSegue, 
sender: AnyObject?) { 
if segue.identifier! == "Passer edit embed" { 
childEditor = segue.destinationViewController as! 
PasserEditTableController 
childEditor.parent = self 


// As a convenience to the client, hold a reference to whatever 
// we're editing. PasserEditController doesn't do anything with it. 
Var representedObject: Passer? 


// MARK: - Child editor support 


var childEditor: PasserEditTableController! 
var editValues: [String:String] { 
get | 
return childEditor.values 


} 

set { 
_savedValues = newValue 
childEditor?.values = newValue 


} 


var _savedValues: [String:String]? 


func childReadyForValues() { 
childEditor.values = _savedValues! 


嵌入 的 segue 与 其 他 segue 一 样 : 它 有 一 个 源 代码 控制 器 和 一 个 目标 控制 器 。 当 触发 时 (从 storyboard 中 载 入 编辑 控制 器 的 
时 候 ) ， 和 其 他 segue 一 样 ， 它 会 得 到 一 个 prepareForSegue (-,sender:) 消息 。 在 这 个 消息 中 ， 它 就 会 得 到 一 个 藤 入 控制 器 
的 指针 (无 法 将 一 个 outlet 链 接 到 Interface Builder 的 子 控件 中 ) 。 


Ors prepareForSegue (_, sender:) KR#it A AKIRA (Passer iA) 的 segue。 确 保 选 中 编辑 控制 器 和 其 表 子 控制 器 之 


间 的 segue， 并 在 Attributes inspectot 中 设置 它 的 名 称 。 不 过 ， 这 个 时 候 视图 还 没有 在 父 节 点 或 者 子 节 点 中 实例 化 。 不 过 当 
viewDidLoad0 被 调用 的 时 候 ， 父 节点 会 依赖 子 视图 的 存在 ， 它 无 法 保证 子 节 点 的 和 存在。 因此， 传递 给 子 节 点 的 值 就 要 等 到 实例 化 


完毕 后 才能 完成 。PasserEditController 公 开 了 一 个 childReadyForValues0 方 法 ， 它 能 完成 接收 信号 的 工作 。 


14.3.2 ”将 数据 传递 给 编辑 器 


首先 ， 我 们 将 数据 放 入 编辑 器 。 我 们 有 一 个 Edit passer segue 形 式 的 编辑 器 进入 点 ， 但 是 我 们 有 两 种 使 用 方法 。 其 中 一 种 
方法 是 添加 Passer， 这 点 很 直接 : Add 按 钮 能 触发 一 个 segue， 这 里 只 有 一 个 Add 按 钮 。 


x 


另外 一 种 用 法 是 编辑 已 经 仓 在 的 passer， 这 是 个 小 扩 巧 。 最 开始 没有 passer; 你 必须 知道 是 哪个 passer 触 友 了 这 个 转换 。 如 
果 你 直接 将 细节 按钮 与 segue 相 连 ， 那 么 这 个 信息 将 会 消失 。 所 以 你 需要 提前 处 理 ， 保 证 信息 消失 之 前 能 够 确定 是 哪个 passer。 


最 直接 的 方法 是 在 PasserListController 中 添加 一 个 老式 风格 的 UITableViewDelegate 方 法 。 


// Remove the in-code setup for the add button so 
// the one connected to the editor segue is used: 
override func viewDidLoad() { 
super .viewDidLoad() 
self.navigationItem.leftBarButtonItem = self.editButtonItem() 


// Handle the new Edit passer segue: 
override func prepareForSegue (segue: UIStoryboardSegue, 
sender: AnyObject?) { 
switch segue.identifier! { 
case "showDetail": 
let indexPath = self.tableView. indexPathForSelectedRow() ! 
let object = (fetchedResultsController[indexPath] as Passer) 
(segue.destinationViewController as GameListController) .detailItem = object 


case "Edit passer": 
let editor = segue.destinationViewController as PasserEditController 
if let passer = _passerToEdit { 
// The accessory button was tapped; capture the selected 
// Passer and its values 
editor.editValues = passer.dictionaryWithValuesForKeys ( 
["firstName", "lastName", "currentTeam"] ) 


editor.representedObject = _passerToEdit 


else { 


// The Add button was tapped; 


there is no existing 


// Passer, and all the values are blank. 
editor.editValues = ["firstName":"", "lastName":"", "currentTeam":""] 


editor.representedObject = nil 


default: 


printin("Unhandled segue in PasserListController (\(segue.identifier))") 


} 


// Respond to a tap on the accessory button for a Passer 


override 


func tableView(tableView: UITableView, 


accessoryButtonTappedForRowWithIndexPath 


indexPath: NSIndexPath) 


{ 


_passerToEdit = (fetchedResultsController [indexPath] as Passer) 


performSegueWithIdentifier ("Edit passer", 


sender: _passerToEdit) 


从 上 次 运行 Passer Rating 到 现在 已 经 有 一 段 时 间 了 。 现 在 重新 运行 一 下 Passer Rating， 单 击 某 行 的 detail-disclosure 按 钮 
或 者 Add 按 钮 ， 新 的 编辑 器 就 会 市 着 填充 好 的 数据 从 讨 部 滑 出 ， 你 可 以 编辑 其 中 的 字段 ， ( 见 图 14.2) 。 
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图 14.2 ”新 的 编辑 器 正如 我 们 预料 的 那样 ， 使 用 存在 的 Passet 数 据 填 充 ， 但 是 无 法 关闭 它 


14.3.3 “从 编辑 器 中 获得 数据 


上 一 节 中 ， 你 无 法 做 到 天 闭 编 辑 器 ， 也 无 法 回 到 模型 中 。 回 溯 到 iOs 5， 解 决 这 个 问题 最 直接 的 方法 是 声明 一 个 
PasserListController 能 够 实现 的 protocol。 当 按 Cancel 或 者 Save 按 钮 的 时 候 ， 编 辑 器 会 使 用 委托 万 法 将 结果 通知 给 列表 控制 
器 。 


当 storyboard 能 够 消除 编辑 器 侧 的 代码 ， 并 且 能 将 client 从 设置 委托 outlet 中 释放 上 且 严 格 地 与 API 保 持 一 致 的 时 候 ， 为 什么 
还 要 这 么 做 ? 


因为 你 无 法 通过 一 个 普通 的 segue 找 到 一 个 视图 控制 器 。 如 果 你 将 一 个 segue 从 Cancel 按 钮 中 control-drag 到 
PasserListController， 你 将 会 得 到 一 个 新 创建 的 passer-list 控 制 器 的 Segue。 它 就是 大 多 数 segue 的 功能 一 一 创建 视图 控制 器 。 





现在 我 们 需要 的 是 一 个 unwind segue, unwind (或 者 exit) segue 会 将 目 身 放 在 视图 控制 嚣 链 中 ， 直 到 它 找到 能 处 理 这 个 
转换 的 控制 器 (如 果 将 这 个 链 人 简单 地 想 和 象 成 segue 触 友 时 候 , 场景 中 一 系列 模型 和 视图 的 表现 ， 那 么 你 束 能 了 解 大 概 的 工作 流 
程 。 不 过 它 更 复杂 一 些 ， 你 也 可 以 在 代码 中 修改 它 ) 。 


视图 控制 器 通过 实现 带 有 类 型 为 UIStoryboardSegue 参 数 的 |BAction 方 法 来 声明 它 已 经 做 好 了 处 理 unwind segue 的 准备 。 
Swift 编译 器 以 及 runtime 并 不 关心 这 些 属性 ， 这 些 信息 基本 上 从 此 束 会 消失 。lnterface Builder 却 很 关心 这 些 属性 。 正 如 方法 声 
明 中 的 @IBAction 告 诉 |B 某 个 方法 能 够 处 理 控制 事件 。 带 有 @1BAction 和 参数 类 型 的 方法 能 够 作为 1B 中 unwind segue 的 处 理 


Bio 


按照 定义 ，unwind segue 的 目标 未 定义 。 控 制 行 为 未 定义 的 目标 通过 First Responder 这 个 占 位 符 来 表示 。Unwind segue 
未 定义 的 处 理 器 由 包含 发 送 者 场景 上 工具 栏 中 的 红色 Exit 图 标 表 示 。 你 总 是 从 一 个 占 位 符 (与 创建 其 他 segue 的 方式 相反 ) 开始 
退出 segue， 按 住 control 键 单 击 占 位 待 ， 融 会 弹出 一 个 市 有 项 目 中 定义 的 所 有 unwind@IBAction 的 列表 。 将 处 理 器 的 气泡 抱 到 
触发 unwind 的 控件 上 ， 见 图 14.3。 
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会 触发 segue 的 控件 上 。 从 一 个 已 经 填充 的 处 理 器 入 口上 拖 动 ， 就 会 添加 另外 一 个 作为 潜在 触发 器 的 控件 


在 这 么 做 之 前 ， 首 先 要 提供 这 些 处 理 器 。 有 两 种 退出 编辑 器 的 方法 : Cancel 和 Save。PasserListController 需 要 为 这 两 种 方 
式 都 提供 一 个 处 理 器 。 


// MARK: - Editor completion 
@IBAction func editorDidSave (segue: UIStoryboardSegue) { 
let editor = segue.sourceViewController as! PasserEditController 
// representedObject is set if the editor comes from an 
// accessory button. If it’s nil, it’s from the + button. 
let passer = editor.representedObject ?? 
Passer (managedObjectContext: managedObjectContext) 


passer.setValuesForKeysWithDictionary (editor.editValues) 


// From the "savemoc" snippet: 
var error: NSError? = nil 
if !managedObjectContext.save(&error) { 
NSLog ("In %@: could not save %@", 
"editorDidSave()" 
"Could not update from edited values") 
// MOCSaveException is defined in Utilites.swift 
NSException.raise (MOCSaveException, 
format: "Context: %@", 
arguments: getVaList(["Could not update from edited values"]) ) 
} 
NSLog ("Hit didSave: \(segue.identifier)") 


@IBAction func editorDidCancel (segue: UIStoryboardSegue) { 
// If the edit was canceled, there's nothing to do. 
NSLog ("Hit didCancel: \(segue.identifier)") 


这 样 就 可 以 了 。 你 可 以 创建 一 个 新 的 passer (因为 没有 连接 到 任何 games， 所 以 没有 任何 career dates 或 者 ratings 数 
据 ) ， 或 者 编辑 已 经 存在 的 passer， 那 么 更 改 就 会 显示 在 passer list 和 passer-detail 视 图 中 。 如 果 取 消 ， 什 么 都 不 会 发 生 。 这 就 
是 我 们 想 要 的 效果 。 


14.4 segue 


堆 止 到 现在 ， 我 们 已 经 看 到 了 storyboard 画 布 中 能 出 现 的 4 种 连接 类 型 : Show Detail (通过 导航 器 控制 器 进入 到 下 一 
步 ) ; Present Modally (向 上 滑动 用 于 界面 切换 ， 比 如 说 编辑 器 ) ; Embed (容器 - 子 元 素 的 关系 ) ; 还 有 Relationship, € 
并 不 是 一 个 实际 的 Segue， 而 是 用 于 展示 一 系列 视图 (比如 导航 控制 器 ) 的 控制 器 和 首 个 控制 器 ( 根 视图 控制 器 ) 之 间 的 关系 。 


另外 还 有 3 种 : Present As Popover (表示 iPad 弹 出 视图 中 的 目标 控制 器 ) ; Show Detail (目标 控制 器 已 经 成 为 分 拆 视图 
中 细节 部 分 的 控制 器 ) ; 还 有 Custom (你 拥有 UIStoryboardSegue 子 类 ) ， 见 图 14.4。 


= 





图 14.4 ”Storyboard 编 辑 器 通过 6 种 类 型 的 箭头 表示 segue: a) Show 或 者 ShowDetail， 将 下 一 个 控制 器 放 入 导航 栈 ; b) Present 
Modally , 将 下 一 个 控制 器 作为 模型 视图 展示 ; c) Present As Popover, 使 用 UIStoryboardPopoverSegue , 将 目标 控制 器 展示 为 一 个 


iPad 弹 出 窗口 ; d) Custom, 代表 你 自己 写 的 UIStoryboardSegue 类 ; e) Relationship， 左 侧 显 示 容 器 视图 ， 比 如 导航 控制 器 场景 、 


动态 管理 内 容 场景 ， 右 边 的 场景 是 第 一 个 ; f) Embed， 左 边 的 控制 器 将 一 部 分 视图 留 给 右边 的 单个 控制 器 


ts unwind segues 从 来 都 没有 在 画布 中 出 现 过 ， 从 它们 的 本 质 可 以 看 出 ， 它 们 没有 已 经 确定 的 终点 ， 因 此 无 法 用 图 形 


已 
MTS o 


14.5 “小结 

在 为 Passer Rating 添 加 模型 编辑 器 的 过 程 中 ， 我 们 希望 看 到 UlViewController 这 样 的 表现 形式 ， 但 使 用 UITableView 显 示 
Static cells。 如 果 你 想 要 使 用 静态 单元 格 ， 那 惑 需要 使 用 UITableViewController， 但 这 不 符合 我 们 的 期 性 。 

我 们 使 用 从 入 segue 解 决 了 这 个 问题 ， 将 编辑 器 视图 控制 器 中 的 一 部 分 用 来 运行 表 视 图 控制 器 。 


有 了 表 视 图 之 后 ， 我 们 融 可 以 添加 静态 单元 格 创建 所 需 的 编辑 器 格式 。 你 也 见 到 了 如 何 充分 利用 Key-Value 的 编程 技术 ， 将 
数据 用 最 小 代价 在 3 个 控制 器 和 模型 之 间 传 递 。 


我 们 在 编辑 器 中 放置 了 一 个 模型 segue。 同 时 ,我 也 介绍 了 如 何 解 决 一 个 segue 信 息 可 能 会 在 你 看 到 它 的 时 候 束 已 经 丢失 的 


能 填充 数据 ， 也 要 能 保存 数据 。 这 是 一 个 使 用 unwind segues 的 好 机 会 ， 创 建 我 们 所 需 的 转换 处 理 器 ， 并 将 Cancel 和 Save 
按钮 链接 到 场景 中 的 Exit 占 位 符 。 


最 后 ， 你 看 到 了 Storyboard 中 将 会 使 用 到 的 各 种 segues。 


你 也 学 习 了 可 能 需要 向 管理 者 解释 的 内 容 : Storyboard 证 省 了 大 量 精力 ， 显 闭 减 少 了 犯错 的 可 能 性 ， 但 是 它 并 不 神奇 。 你 
不 能 “仅仅 通过 绘制 ”构建 一 个 应 用 程序 。 每 个 场景 都 需要 通过 你 提供 的 控制 器 对 象 退 回来 。 例 子 看 起 来 非常 神奇 ( 它 会 让 非 技 
术 背 景 的 管理 者 非常 感 兴趣 ) ， 但 是 很 重要 的 代码 还 是 需要 目 己 来 写 。 


图 8.2 中 的 4 个 视图 我 们 已 经 实现 了 3 个 ，Passer Rating 这 个 应 用 程序 看 起 来 已 经 相当 不 错 ， 尽 管 还 有 一 件 事 需 要 处 理 。 


我 不 相信 这 些 评分 (rating) 。 


第 15 章 ”站 元 测试 


截至 现在 ， 我 们 所 有 的 开 友 工作 都 忽视 了 一 个 最 基本 的 问题 : 
你 息 么 知道 它 能 正常 工作 ? 


对 ， 通 党 你 知道 目 己 想 要 的 结果 是 什么 ， 你 也 使 用 Xcode 调试 器 来 确认 应 用 程序 是 否 正 常 工 作 ， 但 是 你 却 没有 时 间 监 控 每 个 
可 能 的 错误 ， 绝 大 多 数 人 都 无 法 做 到 这 点 。 理 想 情 况 下 ， 对 于 每 一 次 修改 ， 你 都 应 该 确认 在 修改 之 后 ， 一 切 都 还 能 正常 工作 。 通 


过 错误 提示 ， 能 够 将 问题 确定 在 上 一 次 修改 的 汽 围 中 。 


这 种 确定 应 用 程序 中 每 一 小 部 分 都 能 正常 工作 的 流程 称 作 单 元 测试 。 这 种 一 丝 不 合宜 找 错误 的 万 式 是 一 种 令 人 疯狂 、 重 复 
追求 完美 的 工作 ， 应 该 让 计算 机 来 完成 这 项 任务 。 


HE 
¢ 


这 是 一 个 非常 好 理解 的 问题 ， 解 决 方案 会 被 分 解 成 测试 框架 的 形式 。 这 种 框架 很 容易 使 用 你 的 代码 ， 与 你 在 实际 环境 中 使 用 
代码 的 情况 笑 不 多 ， 使 用 已 知 的 输入 ， 然 后 将 输出 与 你 所 期 待 的 结果 进行 对 比 。 如 果 一 切 正如 所 料 ， 那 么 测试 成 功 ; 否则 ， 失 
败 。 框 架 提 供 了 一 种 运行 所 有 测试 的 方法 ， 记 录 结 果 并 会 出 具 一 份 报告 。 

单元 测试 是 Xcode 最 重要 的 一 部 分 。 你 选择 的 任何 产品 模板 都 包含 产品 的 一 个 target， 同 时 还 有 一 个 包含 组 成 测试 集合 


(test suite) 的 target， 并 将 它 与 XCTest 框 架 链接 在 一 起 。 


这 个 测试 集合 由 XCTestCase 的 子 类 组 成 ， 它 使 用 以 test 开 头 的 方法 完成 测试 。 测 试 方法 中 的 代码 测试 产品 中 小 的 、 可 管理 
的 功能 ， 并 且 用 断言 (assertion) 验证 结果 。XCTest 断 言 宏 会 根据 条 件 一 一 布尔 值 true 或 者 false、 相 等 或 者 类 似 的 条 件 一 一 检 
查 结 果 ， 如 果 条 件 验证 失败 ， 它 融会 记录 失败 的 测试 和 你 提供 的 质 述 错误 的 信息 。 





尽管 测试 集合 是 一 个 独立 的 target， 但 是 它 无 法 单独 运行 。 它 被 绑 定 到 产品 target 上 ， 被 看 作 是 产品 Test 构 建行 为 的 实现 。 
你 要 记 住 ，Xcode 构 建 的 时 候 有 5 种 行为 : Run、Test、Profile、Analyze 和 Archive。 你 对 Analyze 和 Run ( 当 你 执行 一 个 用 于 
调试 的 应 用 程序 时 使 用 这 个 操作 ) 已 经 非常 熟悉 。 第 16 章 将 会 介绍 Profile， 第 18 章 将 会 介绍 Archive。 本 章 只 关注 Test 的 内 容 。 


选中 Test 操 作 (Product—Test, dU) : 
+ 构建 产品 
- 构建 test target 


- 启动 产品 应 用 程序 


- 将 测试 集合 播 入 项 目 中 ， 运 行 测试 并 收集 结果 
` 关闭 产品 应 用 
如 果 友 现任 意 一 个 测试 失败 ， 那 么 失败 的 消息 会 按照 语法 错误 的 显示 方式 附加 到 代码 和 lssue 导 航 器 上 。 


©; 注意 。 Xcode 的 项 目 模板 一 般 会 带 有 test target, 2A LIA A test target; 在 Xcode 4 中 ，test target 是 可 选项 ， 在 Xcode 之 
前 ， 你 不 得 不 自己 手动 添加 。 如 果 项 目 没 有 test target， 那 么 选中 Project 导 航 器 顶部 的 项 目 文件 ， 显 示 出 Project/Target 编 辑 器 。 单 
击 源 代码 列表 下 面 的 二 按钮 ， 或 者 选中 Editor>Add Target (Project 编 辑 器 的 选项 卡 栏 最 左边 的 小 按钮 可 以 打开 或 者 关闭 源 文 件 
列表 ) 命令 ，Xcode 就 会 显示 出 熟悉 的 New Target 帮 助 界 面 。 在 Othet 目 录 下 可 以 找到 CocoaTouch (或 Cocoa) Testing Bundle 
tatget。 确 保 在 列表 中 选中 了 应 用 程序 对 应 平台 下 的 tatget。 如 果 你 的 产品 面向 的 平台 是 iDS， 而 且 test target ZOS X, ARA 


问题 就 会 变 得 很 复杂 。 除 了 平常 的 细节 问题 之 外 ， 还 允许 选择 一 个 Tatget to be Tested. 


15.1 Test Navigator 


Xcode 6 非常 重视 单元 测试 ， 为 它 提 供 了 专属 导航 器 (图 15.1) 。 这 个 导航 器 列 出 了 项 目 中 所 有 的 测试 用 例 (test 
case，XCUnitTest 子 类 ) 以 及 这 些 类 中 的 所 有 测试 方法 。 每 个 测试 旁边 用 一 个 绿色 对 多 或 者 红色 叉 号 宝石 标记 这 个 test 最 后 一 


次 的 运行 状态 。 


im 
FL 


Passer RatingTests 
9 tests, 1 failing 


CoVFile Tests 
Ei testNoSuchFilef 


testFileReadsCompletely() © 
ql testTooManyFieldsError() 
testNotRun Yet() 
K] testPerformanceExample() © 





图 15.1 Test 导航 器 列 出 了 testtatget 中 的 每 个 XCUnitTest 类 ， 以 及 这 些 类 中 的 每 个 方法 。 右 边 这 一 列 中 的 标记 表示 这 些 测试 最 后 
次 的 运行 结果 : 红色 又 号 宝石 表示 失败 ， 绿 色 对 义 宝 石 表 示 成 功 。 还 没有 运行 的 测试 劣 边 什么 标记 都 没有 ， 但 是 鼠标 划 过 它们 


的 名 称 时 会 看 到 一 个 可 以 单 击 的 Play 按钮 





这 些 标记 不 仅仅 能 够 显示 信息 : 单 击 这 个 测试 或 者 整个 测试 用 例 融 能 运行 所 有 的 测试 。 如 果 你 现在 仅 天 注 一 个 测试 ， 那 么 你 


不 需要 运行 整个 测试 集合 残 能 得 到 你 想 要 的 结果 。 


pd 


这 些 标记 也 会 在 测试 代码 旁边 的 空白 处 显示 出 来 ， 见 图 15.2。 同 样 ， 单 击 这 个 标记 就 会 重复 执行 这 个 测试 。 如 果 一 个 测试 还 
没有 运行 过 (或 者 自从 这 个 项 目 被 打开 后 还 没有 运行 过 ) ， 那 么 它 就 不 会 有 任何 标记 ， 但 是 如 果 用 鼠标 划 过 那 一 行 ， 就 会 出 现 一 
个 Play 按钮 。 


Parse a Enown-good game file just to count the records 
fune testFileReadsCompletely() { 二 


E F 


- YeriLy Lie cepurlk ol pecurds wilh more [ields Llau leaders. 


tune testTooManyFtieldseError() {C= 4 
ff A test we've never run. 


p 


fune testNotRunvYet() fom} 





图 15.2 ”成 功 和 失败 的 标记 会 显示 在 测试 方法 代码 穷 边 的 空白 处 。 单 击 对 应 的 标记 就 能 重新 运行 这 个 测试 


加 注意 Test 导 航 器 能 很 轻松 地 管理 和 运行 测试 用 例 ， 但 是 Scheme 编辑 器 中 还 有 另外 一 个 测试 列表 。Test 行 为 的 Info 选 项 卡 
列 出 了 所 有 的 测试 集合 以 及 对 应 的 测试 ， 你 可 以 选中 其 中 的 测试 集合 运行 。Test 叶 航 器 用 于 运行 你 想 要 调试 的 测试 或 者 测试 类 。 
Scheme 编 辑 器 中 的 测试 列表 控制 着 当 你 选中 完整 Test 行 为 时 运行 的 测试 和 类 。 这 一 点 对 于 日 常 工作 来 说 非常 重要 ,但 是 你 也 可 以 
和 其 他 人 共享 这 些 设 置 ， 只 需 选 中 界面 底部 的 Shared 框 。 共 享 schemes 不 仅 对 于 合作 者 有 用 ， 还 能 驱动 Xcode Setvet 中 的 自动 构建 


和 测试 进程 ， 见 图 15.3。 
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图 15.3 Scheme 编辑 器 中 的 测试 面板 能 让 你 选中 下 次 Test 操 作 运 行 的 测试 。 义 选 界面 下 方 的 Shated 框 ， 就 能 让 项 目 所 有 的 用 户 都 


可 以 使 用 当前 的 Scheme， 而 不 是 只 属于 你 个 人 的 工作 空间 


15.2 ”测试 CSV Reader 


为 了 了 解 单元 测试 的 整个 工作 流程 ， 让 我 们 先 为 SimpleCSVFile 构 建 一 些 测试 用 例 ， 它 是 .csv 数 据 文 件 的 基本 分 析 器 。 我 们 
已 经 拥有 了 一 个 Passer_RatingTests.swift 文 件 。 将 测试 类 的 名 称 更改 为 CSVFileTests， 并 重 命 名 对 应 文件 中 的 内 容 : 对 于 类 名 
来 说 ， 在 Swift 文 件 中 执行 搜索 替换 操作 ; 对 于 文件 本 身 的 名 称 来 说 ， 在 Project 导 航 器 中 选中 对 应 的 文件 ， 按 下 return 键 输入 新 
名 称 。 再 次 按 下 return 键 就 能 确认 名 称 更 改 ， 现 在 文件 旁边 就 会 有 一 个 A+ 的 源 代 码 控制 标记 ， 表 示 它 已 经 用 新 的 名 称 重新 添加 
到 了 本 地 存储 库 中 。 


这 个 文件 有 4 个 方法 。 
' setUP 会 在 每 个 测试 (以 test 开 头 的 选择 器 ) 方法 运行 之 前 执行 。 
` tearDown 会 在 每 个 测试 之 后 执行 。 与 setUp 结 合 在 一 起 ， 你 能 为 每 个 测试 创建 新 的 、 一 致 的 条 件 。 
- testExample 表 示 测 试 的 一 个 示例 方法 ， 因 为 它 的 选择 器 都 由 test 开 始 ， 仅 包含 一 个 XCTAssett (true, =) 。 在 没有 做 任何 
工作 的 情况 下 执行 Test 操 作 ， 将 会 认为 这 个 测试 通过 。 


- testPerformanceExample 是 调用 mearsureBlock0 确 定 代码 性 能 的 测试 框架 。 现 在 ，measureBlock0 收 集 的 唯一 度量 数据 是 执行 
的 时 间 (普通 的 时 间 ， 而 不 是 处 理 器 时 间 ) ， 但 是 API 已 经 为 未 来 更 多 的 测量 标准 留 出 了 余地 。 在 第 16 章 中 我 们 可 以 看 到 更 多 的 


性 能 指标 。 


Oss ” 记 住 ， 你 不 能 依赖 测试 的 运行 次 序 。 如 果 setUp 中 没有 包含 执行 一 个 测试 需要 的 特定 条 件 ， 那 么 这 个 测试 不 得 不 自 


己 配 置 所 需要 的 条 件 。 如 果 你 真 的 需要 一 个 测试 结果 作为 下 一 个 测试 的 前 提 条 件 ， 那 么 你 最 好 将 这 两 个 测试 放 在 同一 个 方法 中 。 


15.2.1 CSV 测试 代码 


我 们 可 以 围绕 测试 做 很 多 工作 ， 而 不 仪 仪 是 愉快 地 接受 它 。 用 一 些 更 合适 的 内 容 蔡 换 testExample， 束 和 像 内 部 管理 代码 (下 
面 是 一 些 摘录 ， 上 下 文中 有 一 些 已 经 存在 的 代码 ) 。 


import Foundation 
import UIKit 

import XCTest 

import Passer Rating 


class CSVFileTests: XCTestCase { 
enum TestFiles: String { 


case GoodFile = "2010-data-calculated.csv"; 
case TooManyFields = "too-many-fields.csv"; 
case NotEnoughFields = "not-enough-fields.csv"; 


} 


// The SimpleCSVFile object to investigate (set in each test) 


var csvFile : SimpleCSVFile? = nil 
// An array of the dictionaries SimpleCSVFile presents while parsing. 
var records : [[String:String]] = [] 


// When the file name is set, load up a parser 


var csvFileName: String? = nil { 
didSet { 
if let fileName = csvFileName { 
let bundle = NSBundle(forClass: CSVFileTests.self) 
let csvPath = bundle.pathForResource (fileName, ofType: "") 


// Yes, assert that the test bundle contains what you 
// think it does. Do you really want to scour your code 
// for a test "failure" that came from a bug in the 
// test itself? 
XCTAssertNotNil (csvPath, 

"Finding \(fileName) in the test bundle.") 


csvFile = SimpleCSVFile(path: csvPath! ) 
XCTAssertNotNil (csvFile, 
"Loading \(fileName) from the test bundle.") 
} 


else { 
csvFile = nil 


override func setUp() { 
super .setUp () 
records = [] 


override func tearDown() { 
super. tearDown () 


// MARK: - Error handling 


// Utility method to verify the NSError object from the 
// CSVError item is as expected. 


fune checkNSErrorContent (error: CSVError, 
requiredDict: [NSObject:AnyObject], 
domain: String = WT9TErrorDomain) { 
let nsError = error.nsError 
XCTAssertEqual (nsError.domain, domain, 
"CSVError object had the wrong domain.") 


if let csvErrorDict = nsError.userInfo { 
// I£ the NSError had a userInfo dictionary, 
// compare it against the keys and values passed in 
// through requiredDict. 
for (key, requiredValue) in requiredDict { 
if let csvValue: AnyObject = csvErrorDict[key] { 
let csvStrValue = "\(csvValue) " 
let requiredStrValue = "\(requiredValue)" 
XCTAssertEqual (csvStrValue, requiredStrValue, 
"CSVError.nsError wrong value for required key \(key)") 
} 


else { 


XCTFail ("CSVError.nsError lacked required key \(key)") 


} 
else { 
XCTFail("CSVError objects are supposed to have dictionaries") 


} 

func testNoSuchFile() { 
// The parser gets a path that doesn't resolve to a file. 
let noSuchFile = "no-such-file.csv" 
csvFile = SimpleCSVFile(path: noSuchFile) 


// Run the parser. It should not pass any data back. 

let result = csvFile?.run{ _ in 
XCTFail ("Nonexistent file should never present a record.") 
return nil 


// It should return a .NoSuchFile error. 
switch result! { 
case let .NoSuchFile (fileName): 
// The file in the error should match the given path. 
XCTAssert (fileName. hasSuffix(noSuchFile), 
"Nonexistent file path should come back through the error") 


// The NSError from the error object should identify the 

// file and explain the error. 

checkNSErrorContent (result!, requiredDict: [ 
NSFilePathErrorkKey: noSuchFile, 
NSLocalizedDescriptionKkKey: "No such file \ (noSuchFile)" 


] 


default: 
XCTFail ("Wrong return for no-such-file.") 


func testFileReadsCompletely() { 
// Parse a known-good game file 
// just to see if the record count is right. 
csvFileName = TestFiles.GoodFile.rawValue 
let result = csvFile!.run { record in 
self.records.append (record) 
return nil 


if let realResult = result { 
// You can't XCTAssertNotNil and refer to “result!” in the 
// message string. XCT evaluates the message before testing 
// the not-nil condition. When ‘result _is_ nil, the string 


// interpolation will crash on the attempt to unwrap it. 


XCTFail ( 
"The good file should produce no errors; got \(realResult) 


} 
XCTAssertEqual (328, records.count, 


"Wrong number of records from \(csvFileName).") 


ord 


正如 我 所 说 的 那样 ， 基 本 上 都 是 管理 代码 。 最 有 趣 的 是 ， 这 些 消 数 的 名 称 都 以 XCT 开 涉 ， 它 们 都 来 自 于 XCTest。 在 这 里 
它们 的 功能 是 确认 测试 所 需要 的 文件 是 否 存 在 以 及 是 否 可 以 读 取 (XCTAassertNotNil) ， 是 否 可 以 被 解析 (用 XCTAssertTrue 
验证 run0 消 数 运行 是 否 成 功 ) ， 记 录 的 数量 应 该 与 我 乙 前 准备 的 一 致 (XCTAssertEqual) 。 在 本 章 后 面 我 们 将 会 看 到 一 份 完 整 
的 列表 。 


你 可 以 看 到 一 个 好 测试 的 魅力 ， 事 实 上 ， 这 些 测试 还 不 够 好 。 测 试 过 程 虽 然 元 繁 , 但 是 一 旦 有 了 这 些 测试 用 例 ， 测 试 程序 束 
会 完成 整个 工作 ， 在 它 处 理 上 百 条 记录 的 时 候 ， 完 全 不 用 你 去 单 步调 试 每 一 行 。 


现在 Xcode 将 会 抛 出 一 些 未 定义 符号 的 错误 。test target 无 法 识别 Passer Rating 类 或 者 方法 。Swift 待 号 一 一 命名 名 、 销 数 
和 类 型 一 一 都 在 模块 中 ， 它 们 与 每 个 库 或 者 可 执行 单元 有 差不多 的 作用 域 。SimpleCSVFile 是 应 用 程序 模块 (Passer Rating) 
的 一 部 分 ， 需 要 让 测试 模块 (Passer RatingTests) 也 能 看 到 它 。 





- 引用 SimpleCSVFile 的 Swift 文 件 必须 包含 语句 import Passet_Rating。 上 面 显示 的 SimpleCSVFile.swift 文 件 已 经 这 么 做 了 。 
- SimpleCSVFile.swift 必 须 将 public 属 性 放 在 每 个 沪 数 和 类 型 之 前 ， 这 样 它们 才能 被 其 他 模块 使 用 。 


在 SimpleCSVFile.swift 中 需要 的 地 方 添 加 public 属 性 。 


public 
enum CSVErrorKeys: String { 


| a 


public 
enum CSVError: Printable { 
case LineFormat(String, Int, Int, Int) 


// While we're at it, make it easier to print out error objects. 
// Defining a ‘description property makes a type comply 
// with Printable , so it can be interpolated into a string 
// with "Ko 
public var description: String { 
var retval = "CSVError." 
switch self { 
case let .NoSuchFile (fileName): 
retval += "NoSuchFile(\(£i1leName) )" 
case let .EmptyFile(fileName): 
retval += "EmptyFile(\ (fileName) )" 
case let .LineFormat (fileName, lineNumber, expected, actual): 


retval += "LineFormat (\ (fileName) :\(lineNumber), + 
"expected \ (expected), got \(actual))" 
case let .ClientError(path, line, error): 
retval += "ClientError(\(path):\(line), " + 
"NSError = \(error))" 


} 


return retval 


} 


public 
var nsError: NSError { 
var userDict: [NSString:AnyObject] = [:] 
ee ma 


} 


public 
let WT9TErrorDomain = "com.wt9t .error" 


// . 


public 
class SimpleCSVFile { 
Ef i 


public 
init(path: String) { 


FE . 


public 

func run(block: ([String: String]) -> NSError? 
i -> CSVError? 

{ 


既然 其 他 模块 都 能 看 到 SimpleCSVFile 类 及 与 它 相 关 的 类 型 和 数据 ， 未 定义 符号 的 错误 束 应 该 不 见 了 


15.2.2 ”测试 数据 


CSVFileTests 类 依赖 enum TestFiles 列 出 的 3 种 数据 文件 : 2010-data-calculated.csv， 这 是 一 个 已 知 完好 的 数据 文件 ; 
too-many-fields.csv， 它 包含 比 headers 多 很 多 的 记录 字段 ; not-enough-fields.csv， 它 包含 少量 记录 字段 。 后 面 这 两 个 文件 
的 作用 是 确认 SimpleCSVFile 类 能 够 捕获 错误 并 禁止 程序 继续 运行 。 


在 本 章 的 后 面 ， 我 们 会 测试 passer rating 这 个 函数 的 准确 性 ， 那 时 我 们 就 需要 一 个 典型 的 game-data 文 件 以 及 另外 一 个 独 
立 的 ratings 文 件 ， 这 个 文件 根据 相同 的 记录 生成 。 


为 此 ， 你 需要 一 个 固定 的 数据 集 ， 而 不 是 每 次 都 由 Passer Rating 的 构建 过 程 重新 生成 数据 集 。 所 以 复制 一 份 当 前 sample- 
data. a 测 斌 数据， 涵盖 了 32 位 passer 一 一 到 一 个 独立 的 文件 (在 这 个 测试 中 是 2010- 
data.csv) 。2010-data-calculated.csv 是 文件 的 “标准 ”版 本 ， 它 是 测试 方法 的 输入 数据 ， 包 含 计算 过 的 已 知 正确 的 结 
2010-data.csv 是 Passer Rating 使 用 的 “常规 ”数据 文件 ， 因 为 它 要 自行 完成 计算 。 


将 测试 数据 拖 入 Project 导 航 器 的 test-target 分 组 中 ， 或 者 使 用 File 一 Add Files 
tohttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (eA) 命令 添加 这 些 文件 。 无 论 用 哪 种 方 
法 ， 都 请 确保 这 个 文件 仅 添 加 到 了 test target 中 。 


Oa 为 了 保证 这 个 测试 可 重复 ， 所 以 请 将 test data 上 传 到 版 本 管理 工具 中 。 


15.2.3 ”运行 测试 程序 


单 击 工具 栏 最 左 侧 的 Action 按 钮 ， 选 中 Test 执 行 这 个 测试 程序 ， 或 者 选择 Product 一 Test (ÆU) 。Xcode 会 先 构 建 Passer 
Rating， 然 后 构建 test bundle。Xcode 中 发 生 的 第 一 件 事 就 是 报告 构建 成 功 (如 果 没 有 构建 成 功 ， 那 么 清理 之 后 重新 构建 ) 。 


\ 一 /一 


当 构 建 完成 后 ， 你 会 看 到 iOS 模 拟 器 启动 并 打开 了 Passer Rating。 这 很 正常 : XCTest 会 将 测试 代码 插入 运行 的 应 用 程序 
中 。 测 试 程序 会 在 实际 的 使 用 环境 中 运行 ， 而 不 是 在 一 个 单独 的 test-bench 环 境 中 执行 。 这 就 是 不 需要 将 SimpleCSVFile.swift 
链接 到 test target 中 的 原因 。 


Passer Rating 会 在 出 现 (出 现 的 时 长 要 看 它 每 次 伦 费 多 长 时 间 重 新 载 入 比赛 数据 ) 后 迅速 消失 ， 然 后 你 就 会 看 到 lssues 导 
航 器 ， 其 中 (如 果 你 一 直 按 照 我 介绍 的 操作 ) 有 一 个 红色 标记 ， 见 图 15.4。 不 过 标记 是 钻石 形 而 不 是 八角 形 ， 测 试 失败 与 编译 错 
误 并 无 二 致 : 单 击 其 中 一 个 标记 ， 融 会 在 测试 代码 上 看 到 一 个 消息 提示 框 。 


Hr qA O 
By Type 


= Passer RatingTests 
1 issue 


v È CS\FileTests. swift 
© -[CSVFileTests 


AC TAssertE qual failed: ("3") is not 
egual to ("2") - First record is on 
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图 15.4 SimpleCSVFile 中 的 一 个 测试 失败 。 测 斌 失败 的 位 置 和 信息 会 出 现在 Issues 导 航 器 中 


其 中 的 一 个 失败 错误 来 自 testTooManyFieldError()， 它 的 意思 是 说 SimpleCSVFile 中 填充 了 比 headers 还 要 多 的 记录 字段 ， 
所 以 parser 拒 绝 处 理 这 个 文件 ， 然 后 返回 一 个 带 有 所 需 信 息 的 CSVError 对 象 ， 这 一 点 做 得 很 好 。 


func testTooManyFieldsError() { 
csvFileName = TestFiles.TooManyFields.rawValue 
let result = csvFile!.run { record in 
XCTFail ("CSV file with the first data line bad should not call out") 
return nil 


if let realResult = result { 

switch realResult { 

case let .LineFormat(file, line, expect, actual): 
// Verify the associated values 
XCTAssert (file.hasSuffix(csvFileName!), 

"File name reported in the LineFormat error") 

XCTAssertEqual (expect, 16, "Expected fields") 
XCTAssertEqual (actual, 17, "Actual fields") 


[kkkkkkkkkkkkkkkx Failed Kk RK KK KR KK RK RK KK / 


XCTAssertEqual(line, 2, "First record is on line 2") 


[kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkx*x]/ 


// Verify the NSError conversion 
checkNSErrorContent(realResult, requiredDict: [ 
NSFilePathErrorKkey : file, 
NSLocalizedDescriptionKkey : 
"File \(file):\(line) has " + 
"\ (actual) items, should have \(expect)" 
CSVErrorKeys.ExpectedFields.rawValue : expect, 
CSVErrorKeys .ActualFields.rawValue : actual 


}) 


default: 
XCTFail ("Expected a LineFormat error, got \(realResult)") 


} 
else { 
XCTFail ( 
"File with too many fields in the first record " + 
"Should yield an error.") 


除了 一 点 ， 错 误 发 生 的 位 置 : 这 个 错误 应 该 发 生 在 第 2 行 ，header 下 面 的 那 一 行 ， 包 含 第 一 个 比赛 数据 ， 原 本 这 个 不 匹配 应 
该 变 得 很 明显 。 返 回 的 CSVError LineFormat 中 的 Int 值 应 该 会 这 么 说 。 但 是 ， 这 个 测试 结果 显示 错误 友 生 在 第 3 行 ， 这 是 错误 
的 。 


15.3 ”测试 和 调试 器 


接 下 来 做 什么 ”你 需要 看 看 这 些 行 中 parser 做 了 什么 。 乎 运 的 是 ， 调 试 器 在 单元 测试 中 也 能 使 用 。 在 SimpleCSVFile.run() 
的 开头 设置 一 个 断 点 ， 然 后 单 击 Test 导 航 器 中 名 称 旁 边 的 红 又 ， 仅 运行 testTooManyFieldsError(0 ， 或 者 单 击 出 现在 方法 定义 空 
自 处 的 红宝石 也 可 以 仅 运 行 这 个 测试 用 例 。 


在 run( 这 个 函数 中 的 断 点 触发 ， 但 是 看 下 Debug 导 航 器 栈 中 的 记录 : 这 个 调用 来 自 Game 的 AppDelegate， 它 不 是 由 测试 
用 例 触 友 的 。 因 为 你 在 Passer Rating 的 上 下 文中 运行 这 个 测试 ， 现 在 看 到 的 是 App 初 始 化 时 运行 的 处 理 程 序 。 单 击 调试 栏 中 的 
Continue 按 钮 ， 等 待 第 二 次 调用 run()。 


这 次 断 点 是 由 测试 用 例 触 友 的 ， 你 可 以 单 步调 试 prepareToRun0。 它 会 将 文件 填充 到 一 个 字符 串 中 ， 然 后 再 把 它 放 到 一 个 
数组 中 。 


linesFromFile = realContents.componentsSeparatedByCharactersInSet ( 
NSCharacterSet.newlineCharacterSet () ) 


当 prepareToRun(0) 返 回 的 时 候 ，run() 使 用 for 循 环 声 历 linesFromFile， 将 每 一 行 填 到 按照 分 号 的 分 隔 填 入 到 对 应 的 字段 
中 。 


如 果 你 观察 一 下 调试 区 域 的 变量 ， 应 该 知道 第 二 次 通过 这 个 循环 的 时 候 ， 显 示 的 是 数据 的 第 一 行 : 但 是 这 一 行 的 字符 串 却 是 
TA! 第 一 行 数据 直到 第 三 轮 循环 时 才能 看 到 ， 方 法 报错 的 时 候 也 是 显示 为 第 三 行 有 错 。 


稍 作 思考 ， 你 束 会 明日 : 因为 这 个 CSV 文 件 是 从 提前 计算 好 的 统计 数据 电子 表格 中 导入 的 。CSV 原 本 是 Microsoft ExcelXZ 
件 ， 编 码 格式 为 Internet Engineering Task Force 的 RFC 4180， 它 支持 Windows 风 格 的 结束 符 一 一 回 车 换行 。 
componentsSeparatedByCharactersinSet() 将 从 newlineCharacterSet 中 获得 的 所 有 字符 都 记录 下 来 了 ，CRLF 对 代表 了 单个 


全 注意 实际 上 ， 基 本 上 不 会 有 人 注意 REFC 4180。 每 位 实现 者 用 自己 的 方式 处 理 引 用 、 转 义 ， 处 理 数 字 和 行 结 束 符 。 这 是 
一 个 很 保守 的 例子 ， 读 起 来 很 流畅 : 确保 你 的 CSV 文 件 严格 遵守 标准 ， 不 过 可 以 允许 其 他 方面 的 瑕 疯 。 


不 要 使 用 会 改变 文件 换行 符 的 文本 编辑 器 打开 这 个 文件 。SimpleCSVFile 支 持 真正 的 CSV 文 件 (只 要 其 中 不 包含 任何 逗号 或 
者 引号 ) ; 它 可 能 属于 多 个 项 目 ; 它 应 该 处 理 出 现在 大 多 数 文件 中 的 换行 符 。 


Extensions.swift 恰 好 有 一 个 String 扩 展 ， 能 够 满足 我 们 的 需求 。 


extension String { 

/// Break the receiver at line endings and return 

/// the lines in an array of String. 

func brokenByLines() -> [ String ] 

{ 
let scanner = NSScanner(string: self) 
let lineEnders = NSCharacterSet.newlineCharacterSet () 
var retval = [String] () 


scanner.charactersToBeSkipped = nil 
while !scanner.atEnd { 
// Alternate between skipping line breaks and 
// reading line content. 
var token: NSString? = "" 
scanner.scanCharactersFromSet (lineEnders, 
intoString: nil) 
var success: Bool 
success = scanner.scanUpToCharactersFromSet (lineEnders, 
intoString: &token) 
if success { 
retval.append(token! as! String) 
} 
} 


return retval 


在 prepareToRun() 中 ， 蔡 换 : 


linesFromFile = realContents.componentsSeparatedByCharactersInSet ( 
NSCharacterSet .newlineCharacterSet () ) 


linesFromFile = realContents.brokenByLines () 


现在 CSVFileTests 中 的 所 有 方法 都 没有 问题 了 。 


15.4 ”添加 测试 类 


既然 你 已 经 确认 数据 跟 你 期 待 的 一 致 ， —— 读 取 CSV 文 件 ， 其 中 包含 预先 计算 的 rating 值 ， 还 有 
completion、yardage、touchdown、interception 的 值 ， 并 通过 passer rating 函 数 生 成 的 值 与 可 能 正确 的 (或 者 说 至 少 是 独 
立 计算 过 的 ) 值 进行 对 比 。 


这 些 数字 都 在 passer_rating 中 ， 所 以 让 我 们 将 它们 分 开 ， 这 样 更 容易 测试 。 


// Note that the function is now declared ‘public . 

public 

func passer_rating(#completions: Int, #attempts: Int, 
#yards: Int, #touchdowns: Int, 
#interceptions: Int) 
-> Double 


// See http://en.wikipedia.org/wiki/Quarterback_Rating 
if (attempts <= 0) { return 0.0 } 


// Compute the components to sum into the rating 
// CHANGED: Break the component calculations into a separate func. 
let components = rating _components (completions: completions, 
attempts: attempts, yards: yards, 
touchdowns: touchdowns, 
interceptions: interceptions) 


// Add the components up 
let retval = components.reduce(0.0, +) 
return 100.0 = retval / 6.0 


public 

func rating_components (#completions: Int, #attempts: Int, 
#yards: Int, #touchdowns: Int, 
#interceptions: Int) 
-> [Double] 


// Statistic-per-attempt, with both converted to Double, 
// recurs in all four components. Make the definitions 
// easier to read and understand by encapsulating it. 
func perAttempt(stat:Int) -> Double { 

return Double(stat) / Double (attempts) 


return [ 
(100.0 * perAttempt ( completions) - 30.0) / 20.0, 
(perAttempt ( yards) - 0.3) / 4.0, 
20.0 * perAttempt ( touchdowns), 
2.375 - (25.0 * perAttempt( interceptions) ) 


] .map (ratingPinner) 


现在 创建 测试 类 : File 一 New 一 file (ÆN) ， 然 后 选中 iOS Test Case Class。Xcode 显 示 的 界面 允许 你 输入 一 个 名 称 
(RatingTest) ， 以 及 一 个 父 类 ， 黑 认 情 况 下 是 XCTestCase。 


但 是 对 于 类 的 名 称 来 况 ， 新 RatingTest.swift 文 件 与 项 目 模板 提供 的 名 称 一 致 。 完 整 的 测试 列表 在 示例 代码 中 一 一 大 多 了 ， 
所 以 这 里 没 法 完全 展示 。 这 里 有 几 个 要 点: 


1) setUp0 使 用 SimpleCSVFile 读 取 2010-data-calculated.csv 文 件 ， 它 包含 “正确 的 ”计算 结果 ， 这 个 计算 结果 的 生成 独 
立 于 电子 表格 。 它 会 将 数据 作为 Dictionary 载 入 名 为 games 的 数组 中 。 


2) testCalculation0 遍 历 了 games， 根 据 统计 数据 计算 passer-rating， 然 后 将 这 个 值 与 标准 值 做 比较 。 


testCalculation0 循 环 在 XCTest... 断 言 中 完成 了 实际 的 工作 。 


// This is inside the record-by-record loop 
// For each record, define a function that 
// yields the integer value corresponding to 
// a key string: 
func i(key: String) -> Int { 

return record[key]?.toInt() ?? 0 


// lhs ?? rhs evaluates to lhs! if non-nil, 

// to rhs if lhs is nil. 

fi 

// Therefore: 

// I£ there is no value for ‘key in ‘record’, 
// that's nil, the lhs expression short-circuits 
// to nil, so return zero. 

// I£ the value for key in ‘record can't be 
// interpreted as an integer, that's nil, so 
// return zero. 

// Otherwise, return the value for ‘key in 

// ‘record’, as an integer. 

// 


// Swift can be terse, but it is ruthless. 


// Compare the two component sets, within epsilon 


var allComponentsGood = true 
for i in 0 .< gcValues.count { 
allComponentsGood = false 
XCTAssertEqualWithAccuracy(components[i], gcValues[i], epsilon, 
"\ (componentNames[i]) does not match at line \(lineNumber)") 


// If the components checked out, compare the passer ratings, 
if allComponentsGood { 
let goldenRating = self.componentFormatter.numberFromString ( 
record["rating"] !) 
as Double 
let myRating = passer_rating ( 


completions: i("completions"), 
attempts: i ("attempts"), 
yards: Lt"varde"}; 
touchdowns: 1("touchdowns"), 
interceptions: i("interceptions") 


) 
XCTAssertEqualWithAccuracy(myRating, goldenRating, epsilon, 
"Passer ratings don't match at line \(lineNumber)") 


如 果 你 在 维基 百科 中 查看 一 下 passer-rating 的 计算 公式 ， 你 就 不 会 惊讶 在 这 里 看 到 的 3 个 断言 一 一 yardage 和 rating 的 两 种 
计算 方式 应 该 与 “正确 的 ”答案 一 致 一 一 导致 了 292 个 测试 用 例 的 失败 。 见 图 15.5 中 Report 导 航 器 中 的 结果 





Os 在 示例 代码 中 ， 你 将 会 看 到 容错 变量 名 不 是 epsilon， 而 是 ? 。 如 果 你 使 用 的 是 Unicode， 为 什么 不 满足 次 好 的 呢 ? 
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图 15.5 Repott 导 航 器 记录 了 从 项 目 打 开 到 现在 所 有 主要 的 事件 。 选 中 一 个 Test 就 会 显示 运行 中 每 个 失败 的 断言 。 幸 运 的 是 ， 根 
据 断 言 上 的 描述 字符 串 可 以 很 容易 确定 哪个 值 是 错 的 


断言 错误 是 单个 主题 (由 于 篇 幅 原 因 ， 和 错误 消息 分 行 显示 ) 的 变 体 : 


RatingTest.swift:88: error: 
- [Passer_RatingTests.RatingTest testCalculation] 
KXCTAssertEqualWithAccuracy failed: 
("2.375") its not equal to ("1.9") 4+/= ("0.001") 
- Yards does not match at line 1 


XCTAssertEqualWithAcuracy 断 言 会 检查 两 个 浮 点 数 是 否 足 够 相近 ， 如 果 是 ， 就 认为 它们 相等 。 应 用 程序 计算 的 yardage 
组 件 是 2.375， 它 与 提前 计算 的 1.9 不 相等 。 这 一 点 在 rating.swift 中 以 下 一 行 表现 出 来 : 


(perAttempt ( yards) - 0.3) / 4.0, 


它 应 该 是 3.0， 而 不 是 0.3。 这 是 一 个 bug。 选 择 Product 一 Test (dU) ， 或 者 工具 栏 最 左边 的 Test 操 作 ， 运 行 Passer 
Rating 项 目 中 的 所 有 测试 。Report 导 航 器 在 所 有 的 测试 上 都 会 显示 绿色 的 记号 。 这 也 是 你 想 看 到 的 (图 15.6) 。 
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图 15.6 ”运行 项 目 中 所 有 的 测试 ， 在 Report 导 航 器 中 创建 一 个 条 目 ， 叶 航 器 中 会 显示 每 个 测试 用 例 的 结果 


之 前 对 rating 的 不 安 看 起 来 是 正确 的 ， 现 在 我 有 一 个 包 合 328 场 比赛 记录 的 测试 ， 看 看 它 是 否 还 是 错误 的 ， 马 上 就 会 知道 
了 。 


全 注意 当 你 编写 一 个 Cocoa 应 用 程序 的 时 候 ， 你 已 经 习惯 了 通过 NSBundle.mainBundle0(INSBundle mainBundle]) RHA X 
件 。 测 试 类 中 这 个 方法 不 好 用 ， 因 为 测试 的 主 包 是 一 个 应 用 程序 ， 而 不 是 一 个 测试 集合 。 正 确 的 方式 应 该 是 引用 包含 类 本 身 的 
€L: 


NSBundle(forClass: RatingTest.self). 


15.5 异步 测试 


在 Xcode 的 早期 版 本 中 ，Apple 强 调 区 分 逻辑 测试 和 应 用 测试 。 风 辑 测试 指 的 是 将 一 个 应 用 程序 的 各 个 元 素 连 接 到 测试 包 中 
分 别 执 行 测试 。 应 用 测试 指 的 是 在 应 用 程序 的 上 下 文中 进行 测试 。 但 是 现在 ， 所 有 的 测试 都 在 应 用 程序 的 上 下 文中 进行 


获得 应 用 程序 的 状态 并 不 难 : 因为 Passer Rating 会 在 开始 测试 之 前 完全 初始 化 ， 你 可 以 让 UIApplication 单 例 作为 应 用 程序 
委托 (AppDelegate) ， 得 到 应 用 程序 的 managedObjectContext， 这 样 束 能 完全 访问 game 数 据 库 。 你 的 代码 能 够 编辑 存储 
的 内 容 ， 比 如 ， 删 除 一 个 Passer 并 确定 也 删除 了 Games 中 对 应 的 内 容 。 如 果 你 足够 聪明 ， 还 可 以 向 
PassserListController (UINavigationController] 页 部 的 这 一 项 ， 是 应 用 程序 委托 window 属 性 的 根 控制 器 ) 发 送 一 条 信息 ， 告 
诉 它 passer editor (一 会 儿 束 能 看 到 ) 已 经 返回 了 新 数据 。 


15.5.1 测试 异步 代码 


但 是 一 个 应 用 程序 中 最 需要 能 够 重复 执行 的 测试 是 人 们 的 交互 操作 和 网 络 事务 ， 它 们 都 依赖 于 循环 的 运行 或 者 完整 的 回调 。 


这 并 不 简单， 截至 现在 ， 在 我 们 看 到 的 简单 模型 中 ， 测 试用 例 可 能 会 在 获得 结果 之 前 返回 。 





Xcode 6 仍然 没有 解决 用 尸 界面 测试 问题 一 一 可 能 没有 上 自动 测试 框架 能 够 做 到 这 一 点 。 但 是 对 于 异步 操作 ， 比 如 网 
络 ，XCTest 添 加 了 一 个 期 望 机 制 可 以 让 一 个 测试 等 待 (等待 时 长 取决 于 超时 时 间 ) 一 个 操作 的 完成 。Passer Rating 没 有 任何 这 
类 操作 ， 但 是 这 里 有 一 些 通 用 的 做 法 : 


- 使 用 测试 用 例 继 承 自 久 CTestCase 的 expectationWithDescription0 方 法 创建 一 个 期 望 对 象 作为 XCTest 管 理 测 试 暂停 的 句柄。 
. 创建 一 个 异步 操作 ， 有 的 时 候 会 包含 一 个 回调 语句 块 。Cocoa 中 的 网 络 API 中 包含 的 基本 都 是 这 种 高 级 操作 。 
: 在 回调 语句 块 中 ， 向 期 望 对 象 发 送 fulfill0 消 息 ， 唤 醒 测 试 机 制 。 现 在 可 以 将 所 有 的 断言 放 在 回调 数据 中 。 
- 在 你 构建 了 这 个 操作 之 后 ， 给 它 一 个 回调 语句 块 ， 触 发 (重新 开始 、 开 始 等 ) 操作 。 
过 调用 waitForExpectationsWithTimeout (-, handler:) 防止 测试 用 例 退 出 ， 给 出 等 待 的 时 间 限 制 以 及 所 有 期 望都 满足 了 


通 
fulfill0 后 ， 执 行 的 语句 块 。 如 果 没 有 超时 ， 没 有 失败 ， 那 么 语句 块 中 的 NSEtror 参 数 将 会 是 nil; 否则 ， 它 会 描述 出 结果 。 


15.5.2 文档 


很 遗憾 ， 我 们 很 难 找 到 关于 新 API 的 文档 。 如 果 你 知道 正在 查找 的 符号 ,或 者 相似 的 符号 ， 那 么 可 以 从 XCTest 框 架 的 接口 声 
明 中 找 。 完 成 这 件 事 的 一 种 方法 是 输入 一 个 断言 名 称 ， 然 后 按 command 键 单 击 它 。Xcode 将 会 展示 XCTest 类 的 文档 。 这 个 文件 
理论 上 并 不 存在 ，Xcode 显 示 的 是 根据 Objective-C 头 文件 实时 转换 生成 的 内 容 。 


这 就 为 我 们 提供 了 另外 一 种 方法 : 选择 File 一 Open Quickly (10) 命令 ， 然 后 输入 任何 与 你 查找 的 内 容 相关 的 内 容 。 
Open Quickly 查 看 器 将 会 根据 你 的 输入 显示 过 滤 后 的 内 容 ， 有 一 些 与 你 的 输入 相 比 并 不 连续 的 内 容 也 显示 了 出 来 。 比 如 说 ， 输 
入 xctexpe 将 会 显 元 XCTestExpectation 和 XCNotificationExpectationHandler。 选 中 任何 一 个 双击 (或 者 选中 后 按 下 return 
BE) 惑 能 市 你 到 包含 这 个 符号 声明 (在 这 个 例子 中 是 XCTest) 的 Objective-C 头 文件 。 


天 于 更 多 查找 API 的 方法 ， 将 在 第 24 章 中 介绍 。 


15.6 XCTestkt= 


断言 (assertion) 测试 预期 结果 的 语句 一 一 是 单元 测试 的 核心 。 如 果 无 法 满足 特定 的 条 件 ，XCTest 束 会 将 这 条 测试 用 
例 标 记 为 失败 。 在 Objective-C 中 ， 断 言 由 包 半 了 很 多 主要 方法 的 安 实 现 。 安 的 主要 目的 乙 一 融 是 隐藏 一 些 不 好 的 代码 ， 这 些 代 
码 用 来 在 测试 运行 的 时 候 验 证 正在 测试 的 值 类 型 。 





Swift 中 不 需要 这 种 运行 时 测试 ， 编 译 器 对 类 型 的 检查 非常 严格 。 在 实际 中 ， 这 融 章 味 着 每 种 要 航 测 试 的 类 型 都 应 该 有 一 个 
独立 声明 的 断言 func。 一 般 类 型 会 让 变 体 很 精简 ; 函数 名 重 载 意味 着 即使 Swift 需要 5 个 不 同 的 通用 类 型 来 断言 不 相等 ， 你 也 可 
能 只 会 看 到 一 个 XCTAssertNotEqual0 函 数 。 在 代码 中 按 住 command 键 单 击 XCTAssertNotEqual(0， 就 能 看 到 详细 情况 。 


断言 尔 数 名 一 般 由 XCTAssert 开 头 (有 一 个 例外 ) 。 这 些 安 的 初始 化 参数 会 根据 需求 不 同 而 各 种 各 样 ， 但 总 是 允许 传 入 一 个 
搞 述 string。 这 个 摘 述 字符 串 是 可 选 的 〈Objective-C 断 言 由 一 个 格式 化 字符 串 和 满足 格式 的 多 个 其 他 参数 结尾 ) 。 所 以 : 


XCTAssertEqualWithAccuracy (components [i], gcValues [i], epsilon, 
"\ (componentNames [i]) does not match at line \(lineNumber)") 


注意 ， 注 释 只 能 用 来 描述 测试 环境 ，XCTest 会 将 任何 不 匹配 的 详细 信息 都 输出 。 
下 面 是 一 些 可 用 的 断言 。 关 于 这 些 断 言 的 功能 以 及 调用 方式 ， 请 查看 Swift 或 者 Objective-(C 接 口 


15.6.1 简单 测试 


下 面 是 一 些 最 简单 的 断言 : 真 或 假 ， 空 或 非 空 。 
这 是 最 简单 的 断言 。 遇 到 这 个 断言 ，XCTest 就 会 记录 失败 用 例 ， 同 时 包含 格式 化 的 消息 。 
杂 的 条 件 ， 别 


如 果 测 试 的 Boolean 表 达 式 错误 (或 者 为 零 ) 就 会 失败 。 如 果 测 试 需要 复 
布尔 测试 应 用 的 一 般 规 则 是 : 零 或 nil 值 为 假 ， 








- XCTAssertTrue/XCTAssert 
的 断言 无 法 处 理 时 ， 就 使 用 这 个 断言 或 者 XCTAssettFalse。 对 于 Objective-C 测 ix, 











其 他 值 为 真 。 
- 久 CTAssertFalse 一 一 如 果 Boolean 表 达 式 为 真 ( 或 者 非 零 ) MAM. 
XCTAssertNil 一 一 如 果 测 试 的 对 象 指针 为 非 nil， 则 失败 。 
- XCTAssertNotNil 一 一 如 果 测 试 的 对 象 指 针 为 nil， 则 失败 。 
15.6.2 Sy 
类 型 ， 相 同 的 初始 条 件 。Swift 加 强 了 这 


NJK NÆ ı 
fst E 


价 断 言 测试 用 于 判断 两 个 表达 式 或 者 对 象 是 否 相 等 。 用 于 比较 的 内 容 应 该 是 相同 
TS 


ae 
一 点 ， 要 求 它们 实现 Equatable 协 议 。Objective-C 在 测试 结果 出 来 之 前 不 会 知道 比较 的 两 个 事物 不 匹配 一 一 即使 是 使 用 有 
测试 失败 。 

















整数 常量 检查 NSArray 元 素 个 数 这 种 小 问题 
XCTAssettEqual 一 一 如 果 相 比较 的 两 个 值 不 等 就 会 失败 。 
- XCTAssertNotEqual 与 XCTAssertEqual 相 反 。 
EE 会 有 一 些 取 整 错误 ， 除 了 简单 值 


对 于 浮 点 数 不 使 用 精确 相等 的 比较 ; 你 不 得 不 假设 可 能 
如 果 相 比较 的 两 个 值 之 间 的 差 值 小 于 epsilon 值 就 认为 这 两 个 值 相等 
失败 。 


测 研 这 些 值 








- XCTAssertEqualWithAccuracy 





的 简单 计算 。 浮 点 数 的 比较 使 用 epsilon 值 
是 否 在 允许 的 范围 内 。 向 宏 传 入 要 比较 的 两 个 值 和 epsilon， 如 果 这 两 个 值 之 间 的 差 值 大 于 epsilon， 就 会 


与 XCTAssertEqualWithAccuracy 相 反 。 





- XCTAssertNotEqualWithAccuracy 
否则 这 个 断言 失败 。 它 会 比较 两 个 对 象 是 否 


余 非 [valuel isEqual:value2], 
字 ， 比 如 isEqual: 不 要 比较 





- XCTAssertEqualObjects (AL FRObjective-C) FE 


价 ， 而 不 仅仅 是 它们 的 指针 (对 于 指针 是 否 相 等 应 该 使 用 XCTAssertEqual) 。 注 意 相 比较 的 对 象 的 顺序 
反 了 。Objective-C 需 要 使 用 这 个 断言 ， 因 为 标量 可 以 通过 简单 旧式 数据 操作 (如 ==) 比较 , 但 是 对 象 不 行 。Swift 中 的 对 象 比 较 
和 标量 比较 没有 区 别 。 

XCTAssertNotEqualObjects ( 仅 限 Objective-C) 一 一 与 XCTAssettEqualObjects 相 反 


- XCTAssertGreaterThan 


- XCTAssertGreater ThanOrEqual 


- XCTAssertLess Than 





- XCTAssertLessThanOrEqual (4% FRSwift) 这 些 测 试 都 显示 在 自动 生成 的 Swift 接口 中 ， 但 是 在 Objective-C 对 应 的 头 文件 


中 没有 。 
15.6.3 FS 


下 面 这 些 断 言 仅 适用 于 Objective-C 测 试 。 如 果 在 不 合适 的 情况 下 执行 销 数 调用 ，| 旧 的 Cocoa API 可 能 会 抛 出 异 第 ， 比 如 说 
错误 的 线程 或 者 接受 非法 参数 。 你 可 能 会 抛 出 目 定 义 的 异常 一 一 但 是 在 Swift 中 束 不 用 。Apple 不 建议 在 日 常 工 作 流 中 使 用 异 
单 ，S9wift 中 不 再 为 寞 单 提供 直接 文 持 。 


STR ”不 使 用 Objective-C 异 常 的 原始 原因 是 因为 异常 处 理 的 性 能 损耗 太 严重 ， 即 便 没 有 异常 抛 出 ， 也 会 对 性 能 造成 影 
响 。 现 在 已 经 没有 这 个 问题 了 ， 但 是 又 有 了 新 的 原因 : 因为 现代 、 高 并 发 、 相 互 依赖 的 应 用 程序 已 经 无 法 在 发 生 严 重 的 错误 之 
后 ， 修 复 自身 或 者 恢复 之 前 的 数据 。 


市 有 表达 式 的 异常 断言 有 两 个 作用 : 部 分 计算 问题 以 及 问题 是 否 抛 出 。 安 中 的 表达 了 式 参 数 会 更 加 详细 。 记 住 ， 赋 值 和 逗号 表 
达 式 都 是 合法 的 ， 所 以 你 仍然 能 够 在 异常 测试 中 捕捉 一 些 值 。 可 以 将 复杂 的 表达 式 封 六 在 辅助 方法 中 ， 内 部 抛 出 的 异常 将 会 传递 
到 断言 安 中。 


XCTest 安 仅 对 表达 式 求 值 一 次 。 


如 果 你 提交 的 表达 式 没有 触发 一 个 异常 ， 那么 就 会 返回 失败 。 





- XCTAssertThrows 


如 果 你 提交 的 表达 式 触 发 了 一 个 异常 ， 那 么 就 会 返回 失败 。 





- XCTAssertNo Throw 


如 果 特 定 类 的 一 个 异 第 没有 抛 出 〈 或 者 抛 出 ) ， 就 会 返回 失败 。 





- XCTAssertThrowsSpecific 和 XCTAssertNoThrowSpecific 
利用 这 种 方法 ， 你 就 能 使 用 NSException 的 子 类 测试 你 的 代码 是 否 符 合 要 求 ， 这 样 就 能 与 其 他 库 抛 出 的 异常 区 分 开 来 。 





- XCTAssertThrowSpecificNamed 和 XCTAssertNoThrowSpecificNamed 一 些 异 常 (通常 是 NSException) 无 法 通过 类 区 分 开 


来 ， 但 是 能 够 通过 表示 异 第 名 称 的 子 类 型 区 分 。 这 些 断 言 的 失败 依赖 于 给 定 类 与 名 称 的 异 第 的 出 现 或 者 消失 。 


15.7 小结 


对 于 程序 员 来 说 ， 目 动 测试 无 疑 极 大 地 和 解放 了 劳动 力 。 你 所 做 的 修改 “可 能 ”对 任何 其 他 部 分 都 没有 造成 任何 影响 ， 但 是 大 
多 数 问题 都 友 生 在 “可 能 ”和 “实际 上 ”之 间 。 一 个 展 好 的 测试 规则 能 让 你 坚 不 犹豫 地 回答 下 面 这 个 问题 : 它 能 继续 正常 运行 
吗 ? 你 会 知道 问题 的 答案 。 有 了 这 种 自信 ， 你 束 能 目 如 地 对 应 用 程序 进行 大 刀 阔 逢 的 修改 。 


在 本 章 中 ， 你 学 习 了 XCTest 的 单元 测试 框架 ， 以 及 如 何 使 用 XCTestCase 类 构建 测试 。 我 带 你 学 习 了 生成 一 个 测试 集合 最 详 
尽 的 过 程 ， 这 个 测试 集合 能 验证 读 取 一 个 CSV 文 件 和 获取 精确 统计 信息 的 过 程 是 否 正确 。 在 这 个 过 程 中 ， 你 会 上 友 现 一 系列 的 
bug， 这 些 bug 大 通过 手动 检 覃 整个 应 用 程序 将 会 难以 有 友 现 。 既 然 你 已 经 有 了 测试 用 例 ， 融 不 用 再 担心 以 后 的 修改 会 重新 引 友 这 


些 错误 。 
最 后 ， 我 介绍 了 断言 ，XCTest 使 用 断言 来 确认 你 期 望 的 是 否 与 实际 的 表现 一 致 。 


现在 ， 让 我 们 继续 完善 应 用 程序 ， 从 Passer Rating 是 否 能 正常 工作 到 如 何 做 得 更 好 。 


= Ee 
第 16 草 ”度量 和 分 析 
Passer Rating 距 离 能 够 让 用 户 实 际 使 用 还 有 很 长 一 段 距离 ， 但 是 它 已 经 运行 了 很 多 次 ， 也 构建 了 一 个 测试 环境 ， 肉 眼看 来 
你 已 经 对 这 个 能 工作 的 程序 充满 了 信心 。 


一 般 情 况 下 ， 限 定 词 (“肉眼 看 来 ”) 包含 的 内 容 要 比 “能 运行 ”包含 的 内 容 多 得 多 。Passer Rating 现 在 有 一 些 速 度 和 内 
存 性 能 问题 。 在 着 手 解决 问题 之 前 ， 你 需要 知道 接 下 来 怎么 做 一 一 分 析 应 用 程序 。Instruments 是 分 析 应 用 程序 的 工具 。 





tS 注意 ”如 果 你 一 直 都 在 跟着 我 之 前 的 步骤 操作 一 一 我 建议 从 上 一 章 结 尾 的 示例 代码 开始 一 一 你 会 发 现 自己 显示 的 统计 信 
息 与 我 这 里 显示 的 统计 信息 有 些 不 同 。 你 和 我 的 计算 机 不 同 ， 设 备 不 同 ， 操 作 系 统 不 同 ， 后 人 台 负 载 、 空 闪 RAM 以 及 存储 空间 都 
不 同 。 所 有 这 些 不 同 对 度量 的 结果 都 有 很 大 的 影响 。 本 章 会 着 重 介绍 最 有 意义 的 两 项 指标 。 





示例 代码 已 经 被 修改 过 ， 于 是 generate-game.rb 会 生成 2014~2053 年 的 联赛 历史 ， 其 中 包括 13054 场 比赛 ， 共 1.1MB。 你 
会 在 相同 的 目录 下 找到 sample-data.csv。 将 项 目 中 的 旧 文 件 用 这 个 新 文件 蔡 换 ， 然 后 在 模拟 器 中 运行 应 用 程序 。 


Passer Rating 的 局 动 过程 化 了 不 少时 间 ， 因 为 数据 集 比 较 大 ， 如 果 你 在 一 台 设 备 上 运行 这 个 App， 它 根本 都 无 法 启动: 当 
你 局 动 应 用 程序 的 时 候 ， 模 拟 器 在 启动 图 片 的 界面 会 停留 21 秒 ， 然 后 就 返回 主 界 面 。 这 是 因为 它 的 局 动 时 间 太 长 : 如 果 App 无 
法 在 20 秒 内 对 用 户 操作 做 出 响应 ， 那 么 系统 监视 器 就 会 终止 这 个 App。 所 以 ， 我 们 应 该 提高 它 的 启动 速度 。 


wis 在 崩溃 dump 中 ， 如 果 发 现 异 常 码 是 0x8badf00d， 那 么 就 说 明 是 监视 器 终止 了 应 用 程序 。 


为 了 分 析 App 的 启动 速度 ， 我 将 在 iPhone 6 上 运行 Passer Rating。iOS 模 拟 器 为 App 工 作 提 供 了 大 量 信 息 ， 但 它 终究 只 是 
一 个 模拟 器 : 模拟 器 比 设备 上 可 用 的 RAM (A) 多 得 多 ， 如 果 模 拟 器 中 的 RAM 消 耗 玛 尽 ， 它 还 会 与 硬盘 发 生 页 交换 。 模 拟 器 
使 用 了 OS X 的 APl， 这 个 共享 的 API 根 据 不 同 的 处 理 器 做 出 了 优化 。 同 时 ， 还 有 很 重要 的 一 点 : 模拟 器 的 CPU 速 度 更 快 。 


为 了 将 Passer Rating 这 个 应 用 程序 安 六 到 设备 上 进行 测试 ， 你 需要 付费 成 为 IOS 开 发 者 计划 (iOS Developer Program) 
的 一 员 ， 注 册 设 备 ， 然 后 获得 一 个 签名 证 书 。 


SiR ”同样 ， 你 测试 的 时 候 可 能 会 使 用 与 我 不 同 的 设备 ， 或 者 你 可 能 还 不 是 开发 者 计划 的 一 员 ， 无 法 在 设备 上 进行 测 
试 。 如 果 没 有 加 入 这 个 开发 者 计划 ， 那 么 这 些 内 容 仅 看 看 就 行 了 。 在 第 18 章 中 ， 会 看 到 更 多 关于 在 iOS 设 备 中 载 入 App 的 权限 相 
关 的 信息 以 及 如 何 操作 。 


Code Signing ldentity 会 授权 Xcode 将 你 的 App 安 六 到 一 台 设 备 上 ， 它 可 以 在 一 个 基础 配置 上 设置 。 通 常 Debug 配 置 会 使 
用 开发 者 认证 ，Release 配 置 会 使 用 友 行 认证 。 因 为 现在 我 们 并 非 处 于 友 布 时 期 ， 所 以 对 于 两 者 都 将 identity 设 置 为 IOS 


Developer。 


插 上 设备 ， 然 后 使 用 scheme 控 件 (Run 和 stop 按钮 旁边 的 控件 ) 中 第 二 段 将 下 一 个 构建 指向 它 。 如 果 你 已 经 启用 了 开发 设 
备 ，Xcode 会 自动 整理 好 包含 Passer Rating 和 设备 的 开发 配置 文件 (development profile) 。 (同样 ， 如 果 对 此 不 太 明 白 ， 请 
参考 第 18 章 的 内 容 。) 


ww 注意 Xcode 的 iPhone SDK 包 含 当前 Mac 和 iO 〇 OS 操作 系统 的 符号 表 , 但 是 它们 没有 更 新 一 些 修复 补丁 ; 当 Xcode 在 它 没 见 过 


的 OS 低 版 本 系统 上 运行 应 用 程序 的 时 候 ， 它 会 从 设备 本 身 中 载 入 符号 表 。Devices 窗 口 (Window—Device, H2) 将 会 解释 这 些 
内 容 。 它 将 会 花费 一 两 分 钟 。 


16.1.1 ” Debug 调试 器 


单 击 Run 按 钮 ，Xcode 残 会 根据 设备 执行 一 个 新 的 构建 ， 然 后 将 这 个 产品 安装 到 手机 上 。 当 完成 这 些 工作 的 时 候 ， 它 融会 局 
动 Passer Rating, 


Ose 如 果 手 机 通过 窗 码 锁定 ， 那 么 在 Xcode 继 续 执 行 前 你 要 先 解锁 。 


Debug 调 试 器 为 我 们 提供 了 第 一 条 线索 : 在 初始 化 期 间 ， 性 能 条 状 图 (performance bar graph) 就 会 显示 出 App 几 乎 完 
全 占用 了 设备 上 的 一 个 内 核 ，CPU 使 用 率 为 900%， 有 的 时 候 低 些 ， 还 有 些 时 候 会 副 近 100%， 见 图 16.1 (现代 设备 有 两 个 或 者 3 
个 处 理 器 内 核 ， 所 以 一 个 进程 可 能 占用 200%， 甚 至 300% 的 CPU， 但 是 因为 Passer Rating 是 单线 程 的 App， 所 以 只 能 利用 单个 
CPU 内 核 ) 。 
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图 16.1 在 Debug 寻 航 器 的 CPU 条 状 图 中 ， 我 们 可 以 看 到 关于 Passef Rating 启 动 时 性 能 问题 的 第 一 条 线索 : CPU 条 状 图 显示 App 在 局 
动 的 时 候 ， 设 备 上 一 个 处 理 器 内 核 占 用 率 达 到 了 1009% 


在 Debug 导 航 器 中 单 击 CPU 条 状 图 ， 将 会 看 到 更 多 信息 : Passer Rating 占 用 处 理 器 时 间 的 详细 历史 记录 、 占 用 的 处 理 器 总 
时 间 以 及 在 可 利用 资源 中 的 占用 率 ， 见 图 16.2。 
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图 10.2” 单 击 Debug 导 航 器 顶部 的 条 状 图 就 能 显示 出 Passef Rating 当 前 的 资源 使 用 情况 ， 以 及 它 所 占 可 用 资源 的 百分比 


首先 我 猜测 SimpleCSVFile 太 简单 导致 效率 不 高 。 我 原 打算 深入 人 研究 解析 器 的 代码 ， 检 查 代 码 并 做 一 些 修 改 ， 针 对 
Objective-C 做 一 些 “ 速 度 优化 ”工作 ， 甚 至 是 添加 一 些 C 代 码 ， 然 后 再 次 尝试 。 


不 要 这 样 做 ,不 要 胡乱 猜测 。1lnstruments 会 精确 地 告诉 你 App 将 时 间 都 花费 在 了 什么 地 方 。 这 就 是 所 谓 的 唾 手 可 得 ， 它 会 
让 你 的 部 分 代码 运行 速度 更 快 ， 达 到 事半功倍 的 效果 。 


单 击 Stop 按 钮 停止 应 用 程序 的 运行 。 


16.1.2 Instruments 


分 析 一 个 应 用 程序 很 简单 ， 起 码 在 开始 的 时 候 不 难 。Xcode 为 此 提供 了 一 个 操作 。 选 择 Product 一 Profile (41) MS, 或 
者 在 工具 栏 的 Action 按 钮 中 选择 Profile 选 项 (你 很 可 能 会 把 它 看 做 一 个 Run 按 钮 ， 但 是 如 果 在 按钮 上 按 下 妃 标 ， 束 会 看 到 它 提供 
了 4 种 单 规 的 操作 ) 。 


分 析 应 用 程序 Instruments 融 会 局 动 并 让 你 选择 你 想 要 做 什么 样 的 分 析 ， 见 图 16.3。 本 章 仪 会 展示 Instruments 的 基本 使 


用 ， 第 26 章 会 深入 介绍 。 


Choose a profiling template for: E Fritz's iPhone 6 (8.0.2) > Passer Rating.app 


Custom Recent 


Leaks Multicore Network OpenGL. ES Sudden System Trace 
Analysis Termination 


由 


system Usage Time Profiler — Ul Recorder Zombies 


l Time Profiler 
N Performs low-overhead time-based sampling of processes running on the system's CPUs. 





Open an Existing File... Cancel 
图 16.3 ” 当 Instruments 居 动 后 ， 就 会 出 现 一 个 分 析 类 型 集合 的 模板 选择 器 


Oe 在 后 面 的 运行 中 ，Instruments 将 会 使 用 相同 的 跟踪 模板 。 或 者 ， 你 也 可 以 使 用 Scheme 编辑 器 预先 选择 想 要 使 用 的 


模板 。 


选择 Time Profiler 模 板 ， 然 后 单 击 Choose 按 钮 ， 一 个 用 来 显示 追踪 文档 (trace document) 的 窗口 就 会 出 现 ， 其 中 包含 
Time Profiler 的 记录 。lInstruments 中 有 22 个 文档 模板 ， 每 个 模板 都 包含 一 部 分 分 析 模 块 的 指令 。 这 些 模 块 被 称 为 


instruments。 注 意 ， 我 将 会 解释 清楚 我 的 意思 。 


追踪 文档 也 可 以 自 定 义 : 选中 Window 一 Library (¢6L) ， 打 开 可 用 的 Instruments 库 。 将 你 的 选择 拖 到 文档 窗口 的 顶部 
(如 果 选 择 的 instrument 不 适用 于 当前 的 工作 平台 ， 一 个 黄色 的 和 警告 标记 融会 显示 在 右 下 角 。 你 肯定 不 想 看 到 这 个 警告 ， 即 便 
这 个 功能 恰恰 是 你 想 要 的 ， 它 也 无 法 应 用 于 你 的 应 用 程序 ) 。 


如 果 在 Xcode 中 选中 了 Profile，Instruments 束 会 做 好 分 析 应 用 程序 的 准备 。 如 果 Passer Rating 没 有 立即 局 动 ， 那 么 单 击 
工具 栏 最 左 侧 的 Record 按 钮 局 动 应 用 程序 并 开始 记录 。 在 这 个 例子 中 ，Time Profiler 每 秒 都 会 检查 Passer Rating 代 码 的 执行 以 
及 相关 的 调用 链 。 


与 很 多 instrument 一 样 ，Time Profile 也 会 报告 统计 数据 : 经 过 一 段 足 够 长 时 间 的 运行 ， 每 时 每 刻 的 数据 将 会 构建 一 幅 完 整 
的 “热点 ”图 形 ， 显 示 出 应 用 程序 时 间 消 耗 情况 。 从 这 张 图 中 ， 我 们 能 轻松 地 得 到 直观 的 结论 : 如 果 一 个 为 数 伦 费 的 时 间 最 长 ， 


INNNANNA 


那么 优化 这 个 函数 融 能 大 幅度 提升 应 用 程序 的 效率 。 


当 你 执行 性 能 测试 的 时 候 ，iOS 和 Instruments 为 你 提供 了 一 些 方便 : 监视 器 定时 器 不 会 被 触 友 ， 同 时 Passer Rating 也 会 根 
据 你 的 需要 一 直 运 行 ， 即 便 它 无 法 响应 。 在 我 的 测试 中 ， 应 用 程序 伦 了 50 秒 的 时 间 才 显示 出 初始 passer 列 表 ， 这 是 规定 的 最 低 
时 长 的 两 信 ， 真 是 烛 软 ， 见 图 16.4。 
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会 随 着 时 间 的 变化 显示 CPU 的 使 用 情况 。 下 面 是 Detail 区 域 ， 其 中 的 栈 信息 包含 了 执行 的 代码 


诚实 的 分 析 


事实 上 ， 情 况 比 现在 还 糟 ， 因 为 我 作 浆 了 。 查 看 Passer.swift] 页 部 的 这 段 代码 : 


4 


var allPassers: [String: AnyObject] = [:] 


enum PasserFetchStrategy { 
case HorribleKludge; 
case StraightCoreData; 


let fetchStrategy:PasserFetchStrategy = .HorribleKludge 


当 Game.loadGames() 从 示例 文件 中 读 取 了 一 条 记录 后 ， 它 调用 Passer.existingPasserBy Name (-,last:,context:) 来 检查 
链接 到 Game 对 象 的 已 存在 Passer 对 象 。 如 果 没 有 已 经 存在 的 Passer， 它 就 创建 一 个 。 


查找 占用 了 大 量 的 时 | 间 ， 这 一 点 会 影响 我 的 判断 。 所 以 这 里 有 一 个 特别 的 更 改 : 当 查 找 一 个 Passer 的 时 
候 ，existingPasserByName (-,last:,contect:) 根本 束 没 有 执行 获取 Core Data 的 操作 。 它 在 内 存 字 上 典 allPassers 中 执行 了 查找 


假设 我 们 不 知道 这 一 点 。 不 使 用 真正 获取 Core Data 的 代码 ， 而 是 将 fetchStrategy (获取 策略 ) 从 .HorribleKludge 更 改 
为 .straightCoreData。 再 次 运行 分 析 程序 。 


结果 并 不 好 。 在 我 的 iPhone 6 上 ， 数 据 集 载 入 化 费 了 59 秒 的 时 间 ，3 倍 于 监视 器 允许 的 最 长 时 间 。 新 手 程序 员 可 能 会 将 其 归 
罪 于 代码 优化 器 : 默认 情况 下 ， 项 目 模板 将 分 析 程 序 的 构建 配置 设置 为 Debug， 而 Swift 编译 器 会 设置 为 -Onone 一 一 完全 没 
优化 。 打 开 Scheme 编 辑 器 (Product 一 Scheme 一 Edit Schemehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., Æ<) ， 再 次 选中 Profile 操 作 ， 然 后 将 Build 
Configuration 更 改 为 Release， 也 就 是 -Ofast。 这 样 做 有 帮助 吗 ? 


再 次 执行 分 析 程 序 。46 秒 。 好 多 了 ， 是 允许 的 最 长 时 间 的 两 倍 。 


很 多 有 经 验 的 开 友 者 很 早 束 学 会 了 这 个 技 I5: 这 种 优化 并 没有 解决 我 们 的 实际 问题 ， 我 们 还 是 要 找 出 问题 的 根本 原因 。 


Timer Profiler instrument 会 告诉 我 们 问题 所 在 。 


局 注意 ”还 有 另外 一 个 设置 : -Ounchecked， 它 会 移 除 所 有 运行 时 解 引用 nil 的 安全 检查 ， 还 有 数组 的 边界 检查 等 。 使 用 这 个 
选项 并 非 是 一 个 好 主意 ， 即 便 你 已 经 完全 测试 过 并 且 确 保 这 些 检查 都 不 是 必需 的 。 没 有 谁 能 保证 全 面 的 测试 。 在 一 开始 就 报错 总 
好 过 于 让 应 用 程序 慢 慢 走向 终点 ， 并 崩 江 在 关键 的 位 置 。 我 想 要 给 你 提供 未 检查 构建 的 运行 时 ， 但 是 Xcode 6.1.0 中 的 Swift 编译 器 


会 报错 。 
Time Profile 


关键 的 内 容 在 于 窗口 项 部 的 时 间 线 。 你 可 以 看 到 一 个 区 域 图 ， 它 表示 应 用 程序 每 一 时 刻 使 用 的 设备 处 理 资 源 。 从 应 用 程序 启 
动 到 显示 passer 列 表 的 这 一 段 时 间 内 ，CPU (至 少 两 个 内 核 中 的 一 个 ) 几乎 都 要 消耗 殉 尽 了 ， 占 用 率 接近 100%。 当 应 用 程序 等 
待 从 仓储 中 获取 数据 的 时 候 ， 有 一 段 时 间 内 这 个 图 形 是 实心 块 ， 然 后 偶尔 有 些 流动。 应 用 程序 局 动 的 时 候 ， 在 这 一 部 分 耗费 了 
909% 或 者 更 多 的 时 间 ， 它 也 是 我 们 一 开始 寻找 的 问题 根源 。 


Ste 如果 记录 中 高 负载 都 集中 在 显示 的 最 左 侧 ， 那 么 可 以 执行 放大 操作 。 首 先 ， 确 保 应 用 程序 已 经 停止 。 如 果 仅仅 暂 
停 应 用 程序 ， 那 么 跟踪 记录 还 是 会 计时 。 当 数据 收集 完毕 后 ， 单 击 Stop 按 钮 (也 就 是 之 前 的 Record 按 钮 ) 。 有 3 种 执行 放大 操作 
的 方法 : View 一 Snap Track to Fit (^ 跨 Z) 将 会 放大 显示 区 域 ， 所 以 整个 记录 将 会 填充 时 间 线 视图 ; 在 你 感 兴趣 的 那 一 段 时 间 线 
上 执行 Control-drag 操 作 就 会 仅 显示 这 一 段 时 间 内 的 图 形 ; 最 后 ， 在 时 间 线 左 侧 的 标签 区 域 下 面 有 一 个 带 有 小 突起 的 条 。 向 右 拖 动 
就 会 放大 ， 向 左 拖 动 就 会 缩小 。 它 有 点 像 弹 簧 控制 的 时 间 开 关 - 拖 动 的 距离 越 远 ， 缩 放 的 速度 就 越 快 ， 所 以 要 小 心 点 。 


在 记录 的 末 问 拖 动 女 标 。 当 选中 一 段 记录 后 ， 窗 口 底 部 的 详情 区 域 束 会 只 显示 这 一 段 时 间 内 的 统计 信息 (不 过 看 不 到 详情 区 
域 ， 单 击 工具 栏 中 倒数 第 二 个 按钮 ， 它 看 起 来 束 像 是 一 个 窗口 ， 底 部 高 之 ) 。 


Time Profiler 会 按照 函数 树 的 形式 展示 处 理 负载 。 显 示 的 第 一 行 被 标记 为 Main Thread, Running Time 这 一 列 显 示 Passer 
Rating 在 那个 线程 化 费 的 时 间 。 单 击 标签 旁 边 的 提示 三 角 ， 融 会 看 到 这 一 级 调用 的 六 数 一 一 O3 局 动 轴 数 start， 然 后 是 运行 时 的 
根 main 函 数 ， 最 后 是 你 天 心 的 函数 Game.loadGames (-,context:,error:) 。 在 这 个 函数 树 下 面 ， 记 录 家 分 成 了 独立 的 调用 ， 
其 中 包含 读 取 CSV 文 件 和 通过 SimpleCSVFile.run (-) 。 将 它 转换 成 Passer 和 Game 对 象 这 个 过 程 的 链 。 当 调用 树 分 叉 的 时 候 ， 


会 显示 出 每 一 部 分 运行 时 花费 的 时 间 。 





六 数 树 非常 复 末 ， 它 包含 你 无 法 操作 的 大 量 函 数 ， 因 为 它们 属于 操作 系统 。 可 以 隐藏 这 些 系统 函数 的 调用 : 打开 Extended 
Detail 视 图 ( 它 在 调用 树 详情 的 右边 ， 如 果 看 不 到 这 个 视图 ， 那 么 单 击 工具 栏 中 的 最 后 一 个 按钮 ) ， 同 时 选择 Display Settings 
查看 器 (中 间 的 选项 卡 ) 。 这 个 查看 器 会 过 滤 显 示 内 容 。 义 选 Hide Missing Symbols 和 Hide System Libraries。 现 在 就 只 能 看 
到 应 用 程序 的 代码 (大 部 分 是 你 写 的 代码 ) 以 及 它们 消耗 的 时 间 。 现 在 你 可 以 检查 函数 树 ， 寻 找 化 费时 间 最 多 的 函数 。 


这 种 方式 得 到 的 信息 量 很 大 ， 但 是 却 不 够 直观 。 你 可 以 直接 显示 消耗 时 间 最 多 的 阔 数 ， 而 不 用 上 自己 一 点 点 寻找 。 单 击 Invert 
Call Tree， 这 样 融会 按照 阔 数 人 花费 的 时 间 来 排序 ;调用 树 的 下 面 是 该 阔 数 的 调用 链 ， 这 个 信息 很 重要 。 


比如 : objc_msgSend 用 来 分 友 Objective-C 方 法 调用 ， 每 当 使 用 一 个 Objective-C 对 象 的 时 候 束 会 产生 这 个 调用 。 所 以 这 个 
函数 的 调用 遍布 整个 应 用 程序 。 当 关闭 了 lnvert Call Tree 和 Hide System Libraries 之 后 ， 使 用 搜索 字段 查找 objc 。 按 住 
Option 键 单 击 主线 程 入 口 旁 边 的 提示 三 角 ， 完 全 展开 调用 树 。objc-msgSend 出 现在 很 多 地 方 ， 这 一 毫秒 在 这 里 出 现 ， 下 一 富 
秒 在 另外 一 个 地 方 出 现 。 设 置 Invert Call Tree， 你 会 友 现 这 个 函数 化 费 了 超过 应 用 程序 9% 的 时 间 。 系 统 开销 大 的 函数 调用 与 它 
的 调用 代价 无 天 。 








全 注意 作为 一 个 系统 函数 无 法 避免 你 无 法 对 objc_msgSend 做 任何 事 。 这 就 是 为 什么 要 义 选 Hide System Libraries ik 
列表 中 只 显示 你 自己 的 代码 。 因 为 你 可 以 优化 自己 的 代码 ， 却 无 法 对 系统 代码 做 出 修改 。 


第 一 次 兰 试 一 一 批量 保存 


过 滤 后 的 结果 显示 Game.loadGames (-,context:,error:) 是 罪魁 祸首 ， 它 占据 了 载 入 阶段 时 间 消 耗 的 41%。 双 击 函 数 所 在 
的 这 一 行 。Instruments 会 读 取 Game.swift 文 件 ， 然 后 显示 loadGames 国 数 ， 并 高 亮 显示 最 消耗 时 间 的 那 一 行 ( 见 图 16.5 ) 
在 这 个 例子 中 ， 是 保存 新 Game 的 这 一 行 。 


if !context.save(&savingError) { 


6 Time Profiler = ( > Call Tre Passer_Rating.Game.(loadGames (Pas Q~ 


let passer:Passer = Passer. passerwithFirstName\ 
values ["firstName"]!, 
last: values ["lLastName"]!, 
context: context) 


newGame. passer = passer 
// passer. enqueueGame (newGame ) 
passer.currentTeam = values ["ourTeam" ] ! 


for key in allGameNumericAttributes { 
newGame. setValue(values[key]!.toInt(), forkey: key) 
} 


newGame.ourTeam = values["ourTeam"]! 
newGame.theirTeam = values ["theirTeam"] ! 


newGame.whenPlayed = "_from_yyyy_MM_dd({values ["whenPlayed"] ) 


var savingError: NSError? = nil 
if !context.save(&savingError) { 
printin("Game.loadGames() CSV Loop: save did not work. 
"Line: \(csvFile. LineCount)") 
if let realError = savingError { 


nrintin("FError descriotion = \ 
Game. swift, Line 134- : 0 Samples 





图 16.5 ”双击 Time Ptofiler 调 用 树 中 的 一 行 ， 就 会 显示 行 数 的 源 人 代码， 并 高 之 显示 最 消耗 时 间 的 语 匈 


ca Data 的 一 部 分 。 这 是 我 们 的 持久 化 方法 ， 必 须要 保留 。 不 过 ， 我 们 可 以 减少 它 的 调 
用 频率 ， 每 10 场 比赛 保存 一 次 ， 而 不 是 每 次 都 保存 。 


// in loadGames () 
var batchingCount = 10 
let batchSize = 1 


fi 
parsingError = csvFile.run { (values) in 
// Initialize a new Game, connect it to a Passer... 
if ++batchingCount % batchSize == 0 { 
var savingError: NSError? = nil 
if !context.save(&savingError) { 
printin("Game.loadGames() CSV loop: save did not work. " + 
"Line: \(csvFile.lineCount) ") 
if let realError = savingError { 
printin("Error description = "+ 
"\ (realError.localizedDescription) ") 
} 
else { 
printlin("But the error came back nil!") 
} 
return savingError! 
} 
} 
return nil 
} 
// ... respond to parsing errors... 


// One more save in case the last objects 
// didn't make it into the looped save: 
var savingError: NSError? = nil 

if !context.save(&savingError) { 


println("Game.loadGames() CSV loop: save did not work. " + 
"Line: \(csvFile.lineCount) ") 
return false 
} 


A aa on to the rest of the function 


再 次 运行 分 析 程序 ， 会 友 现 暂停 时 间 已 经 大 幅 减 少 了 一 一 事实 上 差不多 减少 了 10%。 从 局 动 到 显示 passer 列 表 ， 仅 用 了 33 
秒 的 时 间 ， 比 第 一 次 局 动 快 了 两 佑 多 。 这 是 一 个 很 大 的 进步 ; 应 用 程序 在 用 户 的 手机 上 快 了 50%。 


第 二 次 尝试 





game 批 量 复 制 


现在 最 消耗 时 间 的 遂 数 是 SimpleCSVFile.run( )。 双 击 调用 树 中 的 这 一 行 ， 友 现 它 在 下 面 这 条 语句 花费 了 63% 的 时 间 : 


if let userErr = block(values) { 


这 说 不 通 。 它 是 Game.loadGames (-,context:,error:) 调用 的 语句 ， 这 一 块 是 我 们 目 己 的 代码 。 应 该 是 Hide Missing 
Symbols 这 个 设置 隐藏 了 我 们 的 代码 。 取 消 选择 这 个 选项 ， 显 示 这 一 块 的 代码 。 我 们 发 现 ，-PasseraddGamesObject(-) 函 数 消 
耗 了 23% 的 时 间 。 它 来 和 目 于 loadGame 循 环 中 的 调用 ， 因 为 新 Game 链 接 到 其 Passer 对 象 。 


让 我 们 重复 批量 处 理 的 策略 。 这 一 次 有 些 棘 手 : 相 比 于 立即 添加 一 个 新 Game 到 Passer 的 games 关 系 中 ， 每 个 Passer 应 该 办 
计 新 比赛 ， 并 且 每 次 作为 整体 添加 。 下 面 是 Passer 的 节选 : 


let queueCapacity = 20 
var gameQueue: NSMutableSet = NSMutableSet () 


// Put a game into the gameQueue bag; 
// put the accumulated games into this Passer 
// once enough have come in. 
func enqueueGame(aGame: Game) { 
gameQueue.addObject (aGame) 
if gameQueue.count >= queueCapacity { 
flushGameQueue ( ) 


// Add the accumulated games all at once 
func flushGameQueue() { 
self.addGames (gameQueue) 
gameQueue.removeAllObjects () 


class func forAllPassersInContext (人 
context: NSManagedObjectContext, 
body: (Passer) -> () ) { 
// ... fetch all Passers from the context and 
// pass each to the closure the caller provides... 


// Flush the game caches of all Passer objects 


class func flushGameQueues (#context: NSManagedObjectContext) { 
forAllPassersInContext (context) { $0.flushGameQueue() } 


在 loadGames 循 环 中 ，Game 将 下 面 这 行 : 


parsingError = csvFile.run { (values) in 
// 
newGame.passer = passer 


// 


蔡 换 为 如 下 把 新 的 比赛 累计 入 Passer 的 调用 : 


parsingError = csvFile.run { (values) in 


// 


passer.enqueueGame (newGame) 
// 

} 

// 


Passer. flushGameQueues (context: context) 


再 次 运行 分 析 程 序 ， 结 果 是 26 秒 ， 离 我 们 的 目标 更 近 了 一 步 。 





三 次 尝试 一 一 The Horrible Kludge 


现在 ， 最 消耗 时 间 的 是 Passer.existingPasserByName (-,last:,context:) ， 它 占据 了 loadGames 循 环 24% 的 时 间 。 这 也 克 ! 
是 我 们 开始 所 说 的 ，.HorribleKludge 是 让 Passer Rating 满 足 测 试 我 能 做 到 的 最 佳 的 事 。 我 猿 错 了 ， 但 现在 它 是 最 后 最 好 的 选 
IN 


o 


let fetchStrategy:PasserFetchStrategy = .StraightCoreData 


更 改 为 : 


let fetchStrategy:PasserFetchStrategy = .HorribleKludge 


最 后 执行 一 次 分 析 程 序 : 20.1 秒 。 在 最 新 的 iPhone ( 当 我 撰写 本 书 时 ) E, Passer Rating 载 入 了 包含 16000 条 记录 的 示例 
文件 ， 用 来 展示 足够 长 的 运动 生涯 的 数据 。 还 有 很 多 工作 要 做 ， 但 是 提高 了 一 段 重要 代码 3 倍 的 性 能 还 是 对 得 起 一 天 的 工作 的 。 


9 注意 ”有 既然 我 们 已 经 牺牲 了 自己 的 原则 ， 我 们 就 可 以 继续 改善 它 。 在 我 们 的 数据 集中 ， 有 不 到 50 位 passer。 在 内 存 中 保存 
50 (或 者 上 百 个 ) 个 关键 字 和 对 象 记录 并 不 是 件 难 事 ， 但 是 对 于 提高 速度 来 说 却 很 重要 。 不 过 : 我 使 用 四 分 卫 的 全 名 作为 关键 
字 ， 假 设 它们 全 都 不 同 ， 表 仅 索 引 了 一 个 数据 库 ， 也 只 有 一 个 NSManagedObjectContext。 如 果 我 们 制作 一 个 有 多 个 联赛 ( 当 制 作 
Mac 应 用 程序 的 时 候 ， 我 们 的 确 会 这 么 做 ) 的 数据 模型 ， 就 无 法 使 用 一 个 全 局 字典 。 最 后 : 现在 的 解决 方案 并 没有 解决 问题 ， 只 
不 过 掩盖 了 问题 ， 当 记录 达到 16000 的 时 候 问 题 还 会 出 现 。 正 确 的 解决 方案 是 释放 主线 程 ， 立 即 为 用 户 事件 服务 ， 做 法 就 是 将 载 


入 进程 放 到 后 侣 线程 中 处 理 。 


还 有 很 多 工作 可 以 做 ， 这 取决 于 应 用 程序 性 能 和 代码 复杂 性 之 间 的 妥协 。 现 在 CPU 的 时 间 划 分 很 平均 ， 很 难 再 找到 算法 调 
节 CPU 分 配 的 做 法 。 你 下 一 步 要 做 的 残 是 确定 一 个 将 game 填 充 到 passer 的 频率 ， 通 过 试验 找到 这 样 的 一 个 固定 值 。 你 已 经 不 再 
天 心 分 析 调 用 树 ， 而 仪 天 心 载 入 数据 的 时 间 。 


平 运 的 是 ， 有 一 个 工具 可 以 完成 这 个 任务 。 


16.2”XCTest 和 性 能 


Xcode 6 提供 了 另外 一 种 方法 度量 应 用 程序 的 性 能 。Debug 导 航 器 中 的 条 状 图 给 出 了 大 概 情况 ， 但 是 你 可 能 想 查 看 一 些 更 深 
入 的 细节 ， 如 果 你 愿意 ，Instruments 能 为 你 提供 处 理 器 指令 这 一 层级 的 信息 ， 还 有 一 些 介 于 两 者 之 间 的 信息 。 


最 大 的 问题 是 你 要 集中 注意 力 ， 保 持 条 状 图 的 可 见 状态 。 还 需要 查看 设备 的 界面 。 如 果 你 知道 问题 友 生 的 大 概 区 域 ， 使 用 
Instruments 能 为 你 提供 大 量 帮 助 。 没 有 很 好 的 万 法 能 够 检查 你 最 近 的 工作 是 否 损害 了 应 用 程序 性 能 ， 让 你 对 多 个 设备 保持 足够 
的 重视 并 记录 应 用 程序 性 能 的 长 期 趋势 也 不 现实 。 任 何 需要 肉眼 观察 的 工作 都 无 法 自动化， 无 论 它 是 日 党 工作 的 一 部 分 ， 还 是 集 
成 构建 的 一 部 分 。 


你 已 经 阅读 过 第 15 章 ， 知 道 这 是 一 个 非常 适合 单元 测试 的 例子 。Xcode 6 在 XCTest 框 架 中 引入 了 性 能 度量 值 。 

单元 测试 子 类 的 模板 包含 一 个 性 能 测试 示例 : testPerformanceExample()， 其 中 仪 包 含 一 个 measureBlock0 调 用 。 
measureBlock0 非 常 简单 : 它 在 你 提供 的 闭 包 中 添加 了 一 个 计时 器 。 运 行 10 次 这 个 语句 块 ， 然 后 记录 运行 的 平均 时 间 和 标准 偏 
Æ, 
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和 其 他 进程 消耗 的 内 存 。 即 便 是 手机 的 振动 也 可 能 触发 注册 了 Core Meotion 的 后 台 应 用 的 移动 事件 。 最 佳 做 法 是 取得 平均 值 。 


不 过 这 也 有 一 个 负面 问题 : 如 果 你 正在 研究 一 个 非常 耗 时 的 操作 ， 那 么 10 次 循环 就 意味 着 性 能 测试 将 会 消耗 10 倍 的 时 长 。 
在 Passer Rating 这 个 例子 中 ， 你 可 能 想 将 示例 数据 文件 分 割 成 大 约 8 个 赛季 。 如 果 问 题 在 于 read-Game 的 循环 而 不 是 紧 加 操 


作 ， 这 没有 问题 。 


每 当 你 运行 一 个 性 能 测试 的 时 候 ，Xcode 残 会 显示 测试 结果 的 边界 值 ， 更 多 的 信息 在 Results 导 航 器 中 ， 见 图 16.6。 单 击 测 
试 结果 ， 无 论 是 在 导 舰 器 中 还 是 在 源 代 码 中 ， 生 成 一 个 弹出 窗口 显示 10 次 运行 的 时 间 。 


如 果 你 需要 运行 对 时 间 分 析 没 有 帮助 的 代码 ， 那 么 可 以 将 这 段 代 码 包含 在 stopMeasuring(0 和 startMeasuring( 这 两 个 为 数 
之 间 。 

如 果 你 想 知 道 修改 的 内 容 对 性 能 是 否 有 影响 ， 性 能 测试 可 以 将 一 次 运行 指定 为 基准 测试 (Set Baseline) ， 用 于 和 其 他 测试 
比较 。 这 些 报告 将 会 基于 基准 系 能 测试 。 

性 能 度量 可 以 变化 ， 但 是 如 果 错 误 误 差 在 一 次 测试 中 超过 了 10% ，Xcode 就 会 提醒 ， 这 个 数据 超出 了 平均 数据 的 范围 。 默 认 


情况 下 ，Xcode 会 将 这 次 测试 认定 为 失败 ， 不 会 计 入 性 能 记录 中 。 你 可 以 单 击 Set Baseline 按 钮 (或 者 下 次 运行 的 Edit 按 钮 ) , 
强制 Xcode 记 录 这 次 平均 值 。 
Ba | < Test Passer Rating : 5:58:21 AM 


<@> 


Performance Result 


| All | Passed Failed A Performance 


He l 
8.525 
aseline: 10.625 
v 加 testGameReading( DDEV: 10.00% 
Edit 


d iPhone 6 iPhone 6, iOS Simulator 8.1 
Assertions: failed: Time standard deviation is 22% ( 


Value: 5.844 (-31.41%) 





16.6 Result 导航 器 会 显示 性 能 测试 的 累积 结果 。 单 击 日 志 项 左 侧 的 时 间 ， 就 会 打开 一 个 弹出 窗口 ， 显 示 之 前 的 10 次 测试 ， 以 


及 与 指定 为 基准 测试 的 对 比 


现在 XCTest 度 量 的 唯一 值 是 measureBlock 调 用 中 代码 的 实际 消耗 时 | 间 。 如 果 调 用 XCTest (详情 见 第 15 章 ) 的 接口 ， 你 会 
看 到 mearueMetrics 方 法 可 以 使 用 的 其 他 度量 值 。 


在 Passer Rating 这 个 例子 中 ， 性 能 测试 方法 应 该 在 setUp() 遂 数 中 建立 一 个 Core Data 栈 ， 然 后 在 tearDown0) 中 未 条 检查 ， 
看 看 AppDelegate.swift 中 的 managedObjectContext 属 性 以 及 它 依 赖 的 属性 。 


16.3 AG 


在 本 书 的 早期 版 本 中 ， 我 花费 了 本 章 一 半 的 章节 介绍 内 存 instruments 一 一 Allocations and Leaks。 前 些 年 ， 内 存 管理 问题 
比 时 间 性 能 问题 更 重要 : 无 论 如 何 ， 孤 立 对 象 的 内 存 丢 失 (ARTE) 或 者 尝试 恢复 已 经 不 在 的 内 存 (多 次 释放 内 存 ) 都 会 因为 
内 存 问 题 导致 应 用 程序 骨 演 。 


内 存 问题 仍然 是 问题 ， 但 是 Cocoa 现 在 在 Passer Rating 这 么 简单 的 应 用 程序 上 不 会 出 现 内 和 存 问题 。Automatic Reference 
Counting (自动 引用 计数 ) 会 自动 管理 内 存 分 配 和 释放 ，Swift 基 本 杜绝 了 产生 错误 的 可 能 ， 大 量 减 少 了 内 存 问 题 。Swift 提 供 


了 语言 便利 ， 但 也 不 是 完全 的 解决 方案 。Cocoa 开 发 者 仍然 需要 了 解 Cocoa 的 应 用 计数 内 存 沪 理 计数 。 


尤其 是 ， 你 应 该 了 解 retain cycles， 也 就 是 说 ，A 对 象 声 明 拥有 B 对 象 ， 而 B 对 象 声 明 拥有 A 对 象 。A 对 象 用 过 之 后 无 法 将 内 
人 存 返 回 内 和 存 池 ， 因 为 B 还 在 引用 它 。B 对 象 用 过 之 后 也 无 法 释放 ， 因 为 A 还 在 引用 它 。 对 于 这 种 情况 有 很 多 解决 方法 : weak, 
unowned 和 unsafe/undretained 引 用 。 如 果 B 弱 持 有 A， 那 么 A 焉 可 以 被 释放 ， 因 为 弱 引 用 无 法 保 仔 。A 仍 然 强 引 用 B， 当 A 补 释 
放 后 ，B 也 残 可 以 释放 了 。 


Apple 的 文档 中 包含 一 章 名 为 The Swift Programming Language， 深 入 介绍 了 这 个 问题 。 对 此 我 感到 很 高 兴 ， 但 也 有 些 
遗憾 ， 因 为 没有 一 种 更 好 的 办 法 在 这 种 综述 章节 中 曾 述 内 存 管理 的 问题 。 


16.4 人 小结 


本 章 介 绍 了 Cocoa 应 用 程序 中 测试 性 能 和 内 存 问 题 的 3 种 工具 : Xcode Debug 导 航 器 中 的 概要 图 和 显示 ; 基于 时 间 的 分 析 应 
用 程序 ; Instruments 和 XCTest 单 元 测试 框架 中 的 measureBlock 方 法 。 


在 追 路 Passer Rating 中 严重 的 性 能 问题 时 ，Instruments 表 现 得 非常 好 。 它 将 你 从 那些 无 法 解决 问题 的 小 修 小 补 中 解放 了 
出 来 ， 帮 你 精准 定位 了 间 题 所 在 。 它 提供 了 度量 你 所 做 工作 的 工具 ， 以 及 当 需 要 时 及 取 激进 措施 的 信心 。 


Instruments 还 有 很 多 功能 ， 既 包含 应 用 程序 本 身 的 详细 信息 (在 第 26 章 中 ， 我 将 会 深入 介绍 这 些 功能 ) ， 也 包含 使 用 每 个 
Instrument 的 技术 。 


第 17 章 IOS E 


从 NeXTStep 时 代 开 始 ， 框 架 束 成 了 Cocoa 的 一 部 分 ， 框 架 是 bundle (@) 的 一 种 。 框 染 在 一 个 单独 的 目录 中 意味 着 它 是 
一 、 独 立 的 单元 ( 见 第 22 草 ) 。 框 架 的 目录 中 包含 一 个 动态 库 ， 还 有 各 种 资源 ，NI1Bs、 图 片 文件 等 。 库 文件 需要 提供 一 个 集成 
的 、 共 享 的 并 且 可 以 重复 利用 的 服务 包 。 


OS X 系 统 中 广泛 使 用 了 框架 ， 不 仅 在 开源 或 者 商业 项 目 中 随处 可 以 见 ， 操 作 系统 本 身 也 有 专门 的 框架 。 碍 
看 /system/Library 和 /Library 目 录 找 到 Frameworks/ 文 件 夹 ， 其 中 包含 除了 UNIX 内 核 以 外 的 其 他 DOs XAR 


IOS 作 为 Darwin 操 作 系 统 的 分 文 乙 一 ， 由 一 些 系统 框架 构建 而 成 ， 如 Foundation、UIKit 等 。 不 过 Apple 有 一 条 严格 的 规 
则 : App 中 所 有 的 可 执行 代码 必须 都 要 编译 到 一 个 独立 的 二 进 制 文件 中 放 到 应 用 程序 包 中 。 有 一 些 例外 : 比如 说 作为 应 用 程序 逻 
辑 的 脚本 (Corona SDK 中 的 Lua) ， 只 要 它们 不 变 即 可 ; 或 者 载 入 UIWebView 中 的 JavaScript 脚 本 。 


同时 ，iOS 应 用 程序 中 不 允许 有 动态 库 ， 所 以 也 没有 框架 。 如 果 你 想 要 添加 一 些 预 打包 的 代码 到 iOS 应 用 程序 中 ， 那 么 束 不 
得 不 将 它 合 并 为 一 个 静态 库 或 者 从 代码 中 构建 。 


iOS 8 做 出 了 一 些 更 改 。 其 中 有 一 条 特性 束 是 应 用 程序 现在 可 以 提供 系统 级 别 的 服务 ， 比 如 activities (活动 ， 处 理 来 目 于 另 
外 一 个 应 用 程序 的 数据 ) 、 通 知 和 today 挂 件 (widget) 。 实 现 这 些 功 能 只 需要 保持 提供 功能 的 应 用 程序 在 后 台 运 行 即 可 ， 不 过 
代价 束 是 要 消耗 大 量 的 内 存 和 性 能 。 唯 一 合理 的 万 法 就 是 将 这 些 服务 分 割 为 独立 的 包 一 一 框架 。 





本 章 中 ， 我 将 要 添加 一 个 用 户 查 看 的 挂件 ， 当 它 从 屏幕 顶部 向 下 拖 动 显 示 出 Notification Center 的 时 候 就 能 看 到 这 个 挂 


件 。 添 加 这 个 挂件 不 是 为 了 什么 宏伟 的 计划 ， 它 也 没有 多 大 实用 价值 ， 仪 对 Passer Rating 有 些 用 处 。Passer of the 
Day (POTD) 将 会 显示 应 用 程序 中 最 后 选择 的 passer 的 职业 生涯 概况 。 


17.1 j@xToday Target 


第 一 步 就 是 在 项 目 中 添加 Passer of the Day target， 还 有 别 的 工作 要 做 ， 但 是 在 那 乙 前， 首先 要 有 一 个 target 和 存在。 选择 
File>New—Targethttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 或 者 单 击 Project 编 辑 器 底部 源 代 人 码 列表 的 + 按 
tH. 


四 注意 ”看 不 到 源 代码 列表 ? 尝试 单 击 编辑 器 左上 角 的 开关 按钮 。 

New Target assistant 界 面 你 已 经 很 熟悉 了 ， 选 择 iOS 一 Application Extension 一 Today Extension 并 单 击 Next 按 钮 。 
也 注意 “确保 选中 iOS 这 一 分 类 ;选择 用 于 iOS 的 OS X 或 者 相反 的 选项 ， 会 出 现 常见 的 源 代码 困惑 。 

选项 界面 和 平常 的 无 个 同 ， 除 了 两 点 : 

- Organization Identifier 不 可 编辑 。 扩 展 的 标识 符 必 须 继 承 于 它 要 艇 入 的 应 用 程序 。 


. 有 一 个 额外 的 弹出 窗口 : Embed in Application， 扩 展 必须 打包 到 一 个 应 用 程序 中 。 你 会 看 到 项 目 中 包含 的 所 有 应 用 程序 


tareet， 你 应 该 选择 Passer Rating. 


单 击 Finish 按 钮 还 会 弹出 一 个 界面 ， 它 会 询问 是 否 想 要 “激活 ”Passer of the Day 这 个 target 的 scheme。 这 有 一 点 有 趣 
一 一 你 有 一 个 新 的 target， 当 然 想 要 选择 它 的 运行 环境 一 一 但 是 这 样 做 有 一 个 目的 : 扩展 必须 要 包含 在 应 用 程序 中 ， 但 是 当 扩 
展 运行 的 时 候 ， 它 们 其 实在 其 他 应 用 程序 的 上 下 文中 。Today 挂 件 必 须要 在 Notification Center 中 执行 ， 对 于 iOS Simulator% 
说 ， 它 提供 了 一 个 伪 宿 主 程序 。 


新 的 target 在 项 目 和 挂件 的 Link Binary With Libraries 构 建 阶段 中 添加 了 一 个 NotificationCenter.framework 引 用 。 它 与 
其 他 Copy File 构 建 阶段 没有 什么 不 同 ， 不 过 它 会 预先 将 POTD 移 动 到 应 用 程序 Frameworks 目 录 中 ， 还 有 一 个 描述 性 的 名 字 。 


还 有 一 个 新 的 Passer Rating.entitlements 文 件 ， 它 是 com.apple.security.application-groups 的 属性 列表 ， 它 是 一 个 空 数 
组 ，Xcode 马 上 融会 填 宛 这 些 数 组 。 


target 本 身 由 : 用 于 UIViewController 可 能 包含 来 自 于 NCWidgetProviding 方 法 的 TodayViewController.swift、 用 于 挂件 
布局 的 Maininterface-.storyboard、PasseroftheDay.entitlements， 以 及 包含 挂件 Passer Rating-lnfo.plist 的 Supporting 
Files 组 成 。 


以 上 是 准备 工作 。 


17.2 设计 挂件 


直 件 本 身 的 布局 没有 什么 好 说 的 ， 仅 需要 对 GameListController 中 的 横 屏 (wAny/hCompact) 的 billboard 视 图 做 一 些 修 


改 即 可 ， 因 为 Notification Center 中 的 垂直 空间 特别 珍贵 。 最 有 趣 的 部 分 是 可 执行 组 件 的 设计 ， 见 图 17.1。 


FirstName LastName WE Player of the Day 


153.8 
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图 17.1 创建 一 个 GameDB.ftamewotk， 它 会 为 Passef Rating 和 Passet of the Day 提 供 同 样 的 数据 访问 代码 和 通用 StatView 
Passer Rating 和 Passer of the Day 不 是 独立 的 实体 。 
- POTD 需 要 知道 Passer Rating 中 最 后 选择 的 passet 是 哪个 。 
- 两 者 都 使 用 StatView， 它 能 简化 数据 管理 ， 并 能 让 Auto Layout 更 简单 。 
-它们 需要 数据 库 的 通用 访问 接口 。 
-它们 都 使 用 核心 数据 栈 和 NSManagedObject 子 类 处 理 数 据 库 中 的 对 象 。 


大 部 分 工作 都 可 以 通过 编译 Game.swift 和 StatView.swift 文 件 完成 ，Core Data 相 关 的 属性 已 经 在 AppDelegate 中 。 当 开 
发 者 在 它们 之 间 共 享 “ 库 ”的 时 候 ， 最 简单 的 方法 束 是 将 它们 的 库 源 文 件 导 入 项 目 中 。 可 能 有 通用 的 源 代码 基础 ， 但 是 没有 通用 
的 对 象 代码 。 仍 然 保 留 的 是 数据 访问 相关 的 代码 。 


数据 访问 


一 般 情况 下 ， 应 用 程序 数据 会 隔离 在 沙 箱 (sandbox) 中 ， 其 他 应 用 程序 一 一 包括 应 用 程序 的 扩展 
除非 用 尸 使 用 文档 共享 、 相 册 人 资源 或 者 通过 剪贴 板 。 扩 展 也 一 样 。 





都 没有 访问 权限 ， 


IOS 有 个 例外 : 应 用 程序 可 以 通过 订阅 application group (应 用 程序 组 ) 声明 访问 通用 数据 的 权利 。 但 是 不 能 随意 妄 为 
不 能 将 Pages 组 放 到 应 用 程序 的 .entitlements 文 件 并 且 读 取 用 户 的 文档 。 应 用 程序 组 必须 通过 Apple 的 注册 ， 任 何 应 用 程序 
组 中 任何 应 用 程序 或 者 扩展 的 声明 都 会 根据 标记 开 友 者 团队 的 组 标识 符 再 次 检查 。 





注册 一 个 应 用 程序 组 
下 面 介绍 如 何 将 一 个 应 用 程序 与 组 相关 联 。 


选择 Project 导 航 器 最 顶部 的 入 口 选择 Project 编 辑 器 ， 然 后 选择 Passer Rating target。 单 击 Capabilities 选 项 卡 。 找 到 App 
Groups， 然 后 将 开关 置 为 ON (Apple 看 到 了 开关 上 显示 标签 的 必要 性 ) 。 


然后 就 会 看 到 一 个 App Groups 表 ， 现 在 它 还 是 空 的 。 单 击 表 下 面 的 + 按钮 ， 然 后 输入 group.com.wt9t.Passer- 
Rating.widget (如 果 你 没有 像 我 一 样 成 为 开发 者 计划 的 一 员 ， 那 么 Apple 将 会 拒绝 操作 ， 因 为 需要 填 入 你 自己 的 ID) 。 按 
return 键 或 者 tab 键 完成 输入 。 下 面 的 检查 列表 总 结 了 Xcode 将 会 做 的 工作 : 


` 在 权限 文件 (这 个 操作 会 将 Passer Rating.entitlements 文 件 中 将 组 ID 的 值 设置 为 com.apple.secutity.application-groups) 中 添加 


App Groups 权 限 。 
- ÆApp ID 中 添加 App Groups 权 限 (将 它 添加 到 应 用 程序 在 Apple 的 注册 系统 中 ) o 
- 在 App ID 中 添加 App Groups containets 权 限 (同样 也 需要 将 它 添 加 到 应 用 程序 在 Apple 的 注册 系统 中 ) © 


Xcode 将 会 与 开 友 者 计划 在 线 通信 ， 添 加 后 面 两 个 权限 。 有 的 时 候 ， 需 要 重复 尝试 才能 成 功 添加 这 两 个 权限 一 一 有 个 按钮 
可 以 执行 重复 操作 ， 见 图 17.2。 





App Groups 


App Groups: E group.com.wt9t.Passer-Rating.widget 





图 17.2 ”一旦 Apple 接 受 了 组 注册 ，Tatget 编 辑 器 下 面 的 Capabilities 选 项 卡 中 就 会 显示 所 有 已 经 完成 的 步骤 


接 下 来 ， 在 Target 编 辑 器 的 Capabilities 选 项 卡 下 为 Passer of the Day 做 相同 的 操作 。 过 程 相同 ， 但 是 现在 Xcode 已 经 知 进 
了 你 的 组 ID， 所 以 它 会 自动 填充 。 现 在 Passer Rating 和 POTD 已 经 都 注册 到 了 Apple 中 。 


共享 默认 设置 
做 这 一 切 有 什么 用 ? 共享 组 的 应 用 程序 和 扩展 可 以 让 选中 的 数据 对 彼此 可 用 ， 相 同 的 文件 和 用 户 默 认 设 置 (偏好 ) 。 


当 用 户 在 PasserListController 视 图 中 选中 了 一 个 passer 的 时 候 ，Passer Rating 右 会 将 passer 的 姓名 (Passer 实 体 的 关键 
F) 放 到 共享 的 NSUserDefaults 域 中 ， 它 与 app 组 具有 相同 的 名 字 : 


public 


let GameDBContainerKey = "group.com.wt9t.Passer-Rating.widget" 
public 

let GameDBPasserFirstKey = "GameDB.lastPasser.firstName" 
public 

let GameDBPasserLastKey = "GameDB.lastPasser.lastName" 

TH vue SS 


override func prepareForSegue(segue: UIStoryboardSegue, 
sender: AnyObject?) { 
// Work with the shared defaults repository, 
// not the single-app one 


let defaults = NSUserDefaults(suiteName: GameDBContainerKey) ! 


if let segueID = segue.identifier { 

switch segueID { 

case "showDetail": 
let indexPath = self.tableView.indexPathForSelectedRow() ! 
let object = (fetchedResultsController [indexPath] as! Passer) 
defaults.setObject(object.firstName, 

forKey: GameDBPasserFirstKey) 

defaults.setObject (object.lastName, 


forKey: GameDBPasserLastKey) 
(segue.destinationViewController as! 


GameListController).detailItem = object 


case "Edit passer": 


Jw 1... */ 


} 


defaults.synchronize() 


“Passer of the Day 想 要 填充 视图 的 时 候 ， 它 就 会 从 共享 的 配置 中 恢复 名 字 。 


func fillViewContents() -> NCUpdateResult { 
let defaults = NSUserDefaults (suiteName: GameDBContainerKey) ! 
let selectedFirstName = defaults .stringForKey (GameDBPasserFirstKey) 


let selectedLastName = defaults.stringForKey (GameDBPasserLastKey) 
EW came We 


共享 的 默认 存储 属于 Apple 的 一 部 分 ， 称 为 “容器 ”。 
ml 


组 容器 也 可 以 共享 文件 存储 ， 比 如 存储 Game 和 Passer 对 象 的 Core Data, Passer Rating 和 Passer of the Day 可 以 通过 
URL 在 容器 目录 中 找到 对 应 的 文件 。 


/// A URL to the App Group container directory. 


Var sharedDocumentsDirectory: NSURL { 
let fm = NSFileManager.defaultManager () 
return 


fm. containerURLForSecurityApplicationGroupIdentifier ( 


GameDBContainerKey) ! 


/// The URL for the Passer Rating data store. 


var storeURL: NSURL { 
return self.sharedDocumentsDirectory 
. URLByAppendingPathComponent ("Passer _Rating.sqlite") 


/// The app's NSPersistentStoreCoordinator, nearly unchanged 
/// trom the template code. 
Var persistentStoreCoordinator: NSPersistentStoreCoordinator { 
if _persistentStoreCoordinator == nil { 
var error: NSError? = nil 
_persistentStoreCoordinator = 
NSPersistentStoreCoordinator ( 
managedObjectModel: self.managedObjectModel) 
if _persistentStoreCoordinator.addPersistentStorewWithType ( 
NSSQLiteStoreType, 
configuration: nil, 
URL: storeURL, 
options: nil, 


error: &error) == nil { 
// Again: Never abort() out of production code. 
abort () 


} 
return _persistentStoreCoordinator 
} 


Var _persistentStoreCoordinator: NSPersistentStoreCoordinator! 


之 后 ， 两 个 应 用 程序 都 可 以 编辑 和 访问 相同 的 Core Data 文 件 。 在 实际 使 用 中 ， 我 们 要 保证 当 一 个 应 用 程序 使 用 Core Data 
文件 的 时 候 ， 另 外 一 个 不 能 修改 它 。 因 为 POTD 只 能 读 取 Core Data 文 件 ， 所 以 在 这 里 规避 了 这 个 问题 ， 但 是 并 没有 彻底 解决 。 
在 这 个 例子 中 ， 我 的 解决 方案 是 忽略 它 。 


注意 到 现在 为 止 ， 我 们 对 数据 存储 文件 的 策略 仍然 是 在 每 次 启动 Passer Rating 的 时 候 删 除 并 重新 构建 。 在 数据 模型 还 在 
开发 阶段 的 时 候 ， 这 种 做 法 相当 实用 。 但 是 现在 已 经 不 行 了 ， 因 为 还 有 另外 一 个 客户 端 要 引用 相同 的 数据 一 一 先 不 要 管 iOS 不 会 
允许 Today 挂 件 20 秒 还 没有 准备 好 这 件 事 。 示 例 代码 将 会 向 你 展示 Core Data 栈 的 初始 化 和 托管 对 象 类 的 更 改 ， 这 样 只 有 在 数据 库 
不 存在 的 时 候 才 会 重新 构建 。 


17.3 “框架 内 的 共享 库 
我 还 没有 让 你 填充 Passer of the Day? 展 的 内 容 。 现 在 这 部 分 内 容 不 是 特别 吸引 人 ， 它 仅 仪 是 一 个 视图 控制 器 和 一 个 
storyboard。 有 趣 的 部 分 在 于 POTD 和 Passer Rating 如 何 共 享 资 源 。 


我 们 现在 主要 关心 通过 app groups 共 享 数 据 ， 这 个 技术 是 POTD 的 基础 ， 它 还 涉及 共享 资源 和 共享 函数 。 这 两 个 apps 有 很 
多 相同 的 地 方 。 


` 它们 都 需要 基于 常见 的 数据 存储 建立 一 个 Core Datat o 


` 它们 都 需要 读 取 (Passer Rating 还 要 能 阅读 ) Games 和 Passet 的 数据 。 


.它们 都 要 使 用 StatViews 显 示 详 细 信 息 
- 它们 都 使 用 相同 的 日 期 和 数字 格式 。 


只 有 Passer Rating 使 用 sample-data.csv 文 件 ， 但 是 如 果 有 App 之 外 的 逻辑 需要 处 理 Core Data 剩 余 的 业务 ， 那 么 就 不 应 该 将 这 一 


部 分 隔离 在 App 内 部 。 
如 果 外 部 不 需要 使 用 SimpleCSVFile， 那 么 就 将 它 保存 在 数据 存储 之 外 ， 其 他 地 方 没有 使 用 它 


- Passer fatings 属 于 Games 和 Passers; App 没 有 在 其 他 的 地 方 计 算 这 个 值 ， 如 果 在 别 的 地 方 计 算 它 ， 那 么 POTD 可 能 也 需要 这 


个 值 o 它 F rating. swift 中 o 


为 什么 要 重复 这 些 ? 这 些 代码 属 共享 库 ; 共享 的 代码 加 上 资源 文件 束 构 成 了 一 个 框架 。 框 架 能 够 管理 独立 的 数据 存 
储 ， siiani 


在 Passer Rating 外 面 重 构 共 享 的 代码 ， 首 移 要 添加 一 个 框架 target: 
File>New—Targethttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..., 7Afaizt£zIOS— Framework&Library—Cocoa 
Touch Framework。 单 击 Next 按 钮 ， 然 后 将 框架 命名 为 GameDB， 同 时 将 Language 设 置 为 Swift。 同 样 ， 选 项 界面 提供 了 
Embed in Application 的 选项 ，Passer Rating 是 唯一 可 用 的 选项 。 在 OS X 中 ， 你 可 以 将 发 布 放 入 Library/ 目 录 的 框架 ， 共 享 给 
所 有 的 进程 。iOS 限 制 了 第 三 方 框架 的 使 用 ， 它 只 能 在 单个 的 应 用 程序 上 下 文中 使 用 。 


因为 你 将 Passer Rating 作 为 框架 的 容器 ，Xcode 会 将 GameDB.framework 添 加 到 app 的 Link Binary With Libraries 构 建 阶 
段 ， 还 有 它 的 Target Dependencies ( 见 App 中 Target 编 辑 器 的 Build Phase 部 分 ) ， 连 接 Passer of the Day。 每 当 你 构建 
Passer Rating 的 时 候 ，Xcode 就 会 保证 先 构 建 其 他 两 个 target。 


Xcode 仅 为 你 提供 了 几 个 文件 : 用 于 单元 测试 的 GameDBTests.swift; 在 框架 和 测试 中 都 会 用 到 的 Rating-Info.plists 文 
件 。 有 一 件 事 可 能 会 让 你 很 惊讶 : GameDB.h。 不 用 回 过 头 看 ， 你 的 确 将 语言 指定 为 了 Swift。 不 管 怎 样 ， 共 享 库 对 Objective-C 
代码 来 说 是 可 共享 的 ， 也 可 以 用 Objective-C 语 言 写 。GameDB.h 是 一 个 umbrella file (包括 头 文件 ) ， 它 应 该 #include 那 些 要 
暴露 给 客户 端的 Objective-C 类 的 头 文件 。 


» tE Xcode 会 生成 一 个 module-name-Swift.h 头 文件 ， 将 Swift API 骏 鼓 给 Objective-C， 头 文件 中 包含 (@intetrface 中 所 有 定义 


为 public 的 符号 。 可 在 iBooks 中 阅读 《Using Swift with Cocoa and Objective-C》 这 本 书 了 解 详 情 ， 该 书 免 费 。 


还 有 一 个 让 人 惊讶 的 问题 : 没有 源 文件 。 你 不 得 不 创建 一 个 自己 的 源 文件 。 框 架 会 构建 一 个 根 类 用 来 初始 化 库 文 件 ; 它们 能 
其 他 类 ， 不 过 你 要 创建 与 之 对 应 的 根 类 ， 并 上 且 在 框架 的 Passer Rating-Ilnfo.plist 中 加 以 区 分 


3Sa 


创建 一 个 新 类 ，GameDB (ÆN, iOS—Source—Cocoa Touch Class) 。GameDB 将 会 包含 一 个 initialize0 类 函数 初始 化 


一 一 


库 ， 还 有 一 个 loadSampleData() 国 数 ， 它 之 前 是 Passer Rating 中 AppDelegate 的 一 部 分 


private var _gameDB: GameDB? = nil 


public 
func sharedGameDB() -> GameDB { 
if _gameDB != nil { return _gameDB! } 


_gameDB = GameDB() 
return _gameDB! 


public 
class GameDB: NSObject { 


override public class func initialize() { 
initUtilities() 


/// The bundle that contains this class (the framework), 
/// where resource files are to be found. 
var gameDBBundle = NSBundle(forClass: GameDB.self) 


[xx 
Create and initialize the data store. 
:param: baseName the base name of the .csv file containing 
the initial data. 
:param: createIfAbsent whether the file should be created 
if it isn't there. The app, which has time to do this, 
should pass true; the widget, false. 
:param: error a by-reference pointer to an NSError, valid 
only if the function returns false 
:returns: true if, one way or another, the data store is 
present and loaded. 
:returns: false if the data store is absent, and could/should 
not be created. 
x / 


public 
func loadSampleData(baseName: String, 
createlIfAbsent: Bool, 
error: NSErrorPointer) 
-> Bool 


// Is the store file there? If so, the work is done. 
if storeExists { return true } 


// By here there is no store. Can we create one? 
createStore = createlIfAbsent 
if !createStore { return false } 


// Yes, create it. 
if let csvPath = gameDBBundle.pathForResource ( 
baseName, ofType: "csv") { 
// .loadGames will call through to 
// sharedGameDB() .managedObjectContext, 


// which in turn will create the Core Data stack. 
let success = Game.loadGames(csvPath, error: error) 
return success 


} 


return false 


public 
var managedObjectContext: NSManagedObjectContext { 
if _managedObjectContext == nil { 


let coordinator = self.persistentStoreCoordinator 
_IManagedObjectContext = NSManagedObjectContext () 
_IManagedObjectContext.persistentStoreCoordinator = 


coordinator 
} 
return _managedObjectContext 
} 
var _managedObjectContext: NSManagedObjectContext! 
/* ... and so on through the rest of the Core Data stack. 


See the original code in AppDelegate.swift. 


*/ 


现在 将 托管 对 象 的 类 和 支持 工具 移动 到 GameDB 中 ， 在 Project 导 航 器 中 选中 它们 ， 然 后 在 File inspector 的 复 选 框 中 将 
target 从 Passer Rating 更 改 为 GameDB。 


@ Passer Rating.xcdatamodeld 
è rating.swift 

è SimpleCSVFile.swift 

@ StatView.swift 


® Utilities.swift 


@ Game.swift 
@ Game.swift 


@ Passer.swift 
@ Passer.swift 


@ sample-data.csv 


Passer Rating 基 本 上 只 使 用 Extensions.swift 中 的 扩展 功能 。 其 中 有 一 个 例外 就 是 String 的 brokenByLines0 扩 展 ， 将 这 个 
国 数 复制 到 GameDB.swift 中 。 





Og Swift 类 无 法 用 于 其 他 模块 一 一 客户 端的 框架 或 者 单元 测试 
API， 除 非 父 类 也 是 public， 否 则 它们 无 法 声明 为 public， 从 _Game 和 _Passet 中 可 以 看 出 这 一 点 。 它 们 都 是 由 mogenetator 创 建 ， 你 


除非 它们 及 你 想 要 公开 的 方法 用 public 标 识 。 这 些 
无 法 编辑 它们 。 当 我 撰写 本 节 内 容 的 时 候 ， 最 新 的 mogeneratot 版 本 还 没有 将 机 器 生成 类 和 (@NSManaged 属 性 标记 为 public， 它 们 必 
须要 编辑 。 一 个 拉 取 请 求 需 要 添加 这 些 标签 ; 检查 机 器 生成 的 代码 ， 按 需 编 辑 。 


现在 我 们 已 经 将 托管 类 放 到 单独 的 地 方 人 存储， 为 了 简单 起 见 ， 我 们 可 以 将 它们 指向 全 局 的 NSManagedObjectContext。 详 
见 示例 代码 。 


将 一 切 包装 好 后 ， 在 工具 栏 的 Scheme 弹出 窗 中 选择 GameDB， 然 后 选择 Product-Analyze (B) 命令 。 将 会 出 现 一 些 
构建 错误 ， 现 实 就 是 这 样 ， 不 可 能 一 帆 风 顺 。 让 我 们 找到 问题 所 在 。 


接 下 来 ， 切 损 色 Passer Rating scheme， 修 改 遇 到 的 错误 。 问 题 非 癌 多 ， 涉 及 AppDelegate、GameListController、 
PasserEditController， 还 有 PasserListController: GameDB.framework 中 的 Core Data 和 其 他 符号 在 Passer_ Rating 模 块 中 已 
经 不 可 见 ; 你 需要 添加 import GameDB 引 入 这 些 对 象 。 


AppDelegate 已 经 变 得 很 简单 。 处 理 Core Data 的 函数 和 属性 已 经 。 大 部 分 来 自 于 模板 的 其 他 函数 都 可 以 留 空 。 其 中 
有 一 个 例外 : 

@UIApplicationMain 

public 


class AppDelegate: UIResponder, UIApplicationDelegate { 


override public class 
func initialize() { 
// Initialize the shared defaults store with 
// empty first and last names. 
let groupDefaults = NSUserDefaults ( 
suiteName: GameDBContainerKey) 
groupDefaults?.registerDefaults ([ 
GameDBPasserFirstKey: "", 
GameDBPasserLastKey: ""]) 
} 


var window: UIWindow! 


func application(application: UIApplication!, 
didFinishLaunchingWithOptions launchOptions: NSDictionary!) 
-> Bool { 
let navigationController = 
self.window!.rootViewController as! UINavigationController 
let controller = 
navigationController.topViewController as! PasserListController 


var error: NSError? = nil 


return sharedGameDB().loadSampleData ("sample-data", 
createlIfAbsent: true, error: «error) 


func applicationWillResignActive (application: UIApplication!) { 
// Update the store for the widget to read 
sharedGameDB () .saveContext () 


func applicationWillTerminate(application: UIApplication!) { 
sharedGameDB () .saveContext () 


// ... plus application{Did/Will}Enter {Back/Fore}ground, 
// and applicationDidBecomeActive, which are empty. 


运行 Passer Rating， 测 试 那些 已 经 移动 到 库 文件 中 的 功能 。 〈 遇 到 了 问题 ”示例 代码 中 故意 引入 了 一 些 错 误 。) 现在 你 
经 十 分 欣喜 ， 因 为 再 也 不 用 每 次 都 重新 构建 数据 库 了 。 


17.4 Today 扩 展 


当 其 他 组 件 都 已 经 很 稳定 后 ， 我 们 开始 集中 精力 制作 Passer of the Day 这 个 扩展 。 


Mainlnterface.storyboard 开 始 是 一 个 320 point 的 场景 ， 中 间 有 一 个 UILabel。Xcode 知 道 这 是 一 个 Notification Center 
圭 件 ， 所 以 它 给 视图 添加 了 一 个 深 灰 色 的 育 景 与 NC 视 图 相 匹 配 ， 见 图 17.3。 


Today View Controller 


Hello World 
Attempts 0 Touchdowns 0 


Completions 12 Interceptions 12 


Yards 12 





图 17.3 Passer of the Day 挂 件 包 含 两 个 表示 hame 和 tating 的 标签 ， 还 有 5 个 StatView。 它 们 都 要 conttol-dtagged (control 464%) 到 


Today ViewController #7 @IBOutlet var 上 


这 个 任务 比 我 在 第 12 章 中 介绍 的 那个 复杂 的 流程 简单 得 多 。 复 杂 的 Today 挂 件 可 以 从 size class 中 获 益 : iPad 将 会 在 iPhone 
的 模拟 器 上 运行 只 有 iPhone 版 本 的 应 用 程序 ， 但 是 Notification Center 将 会 全 屏 显 示 。 所 以 挂件 的 布局 应 该 在 任何 尺寸 的 屏幕 
上 看 起 来 都 很 不 错 ， 当 然 你 可 能 想 要 充分 利用 空间 多 显示 一 些 信息 。 想 法 很 好 ， 不 过 我 们 不 会 那样 做 。 


将 文字 标签 放 在 视图 的 顶部 ， 表 示 passer 的 name 和 rating。 将 它们 设置 为 动态 标题 字体 ，name 与 leading 边 界 对 
齐 ，rating 与 trailing 边 界 对 齐 ，Color 设 置 为 白色 ，Background Default 设 置 为 空 。 将 它们 与 最 近 边 的 距离 固定 为 8 point， 同 
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时 对 齐 它们 的 基准 线 。 


你 可 能 不 得 不 使 用 上 下 栏 的 弹出 窗口 ， 





全 注意 Interface Buildet 会 鼓励 你 在 absttact margins Felayout guides 中 使 用 偏 移 量 
强制 偏 移 量 使 用 视图 靠近 边缘 的 相对 值 ， 但 是 我 发 现 使 用 绝对 偏 移 量 会 比 使 用 intelligent (智能 推导 的 值 ) 更 加 可 靠 。 


StatViews: 垂直 方向 上 与 最 近 的 邻居 保持 8 points 的 距离 一 一 父 视图 的 边界 和 上 面 的 视图 。 所 有 的 宽 高 都 相等 。 将 左 列 的 
上 边界 与 石 询 的 上 边界 对 齐 。 


下 面 有 一 个 小 技巧 可 以 让 宽度 设置 正确 : 在 画布 左 侧 的 文档 大 纲 中 ， 在 Attempts 的 StatView 上 按 住 control 键 拖 动 到 挂件 的 
父 视图 上 ， 然 后 选择 任何 一 个 X-offset 约 束 一 一 你 将 会 修改 这 个 约束 。 选 中 Attempts 视 图 ， 在 Size inspector 中 找到 新 的 约束 ， 
NEE. EMIR: 


(center of the view) = (trailing edge of Attempts) + 8 
或 : 
(trailing edge of Attempts) = (center of the view) - 8 


相等 的 宽度 和 边界 偏 移 : StatView 接 近 中 心 的 边 与 中 心 保 持 8 points 的 距离 ， 因 此 左 列 和 右 列 中 间 的 距离 就 轧 是 16 points 


J. MRCS, MRAZ, HSS PRR BA. 
Yards 条 目 与 包 妆 器 视图 底部 之 间 的 距离 保证 了 挂件 总 是 能 够 完整 地 显示 它 的 内 容 。 


确保 Font Color 为 白色 ， 然 后 将 Font Size 设 置 为 14。 如 果 你 不 得 不 在 iOS 模 拟 器 上 缩小 窗口 ， 那 么 笔画 将 会 变 得 很 细 ， 难 
以 阅读 ， 但 是 如 果 你 设置 Window 一 Scale 一 100%， 就 会 发 现 字母 很 清晰 。 


文档 大 纲 中 将 会 显示 所 有 的 StatViews， 约 束 的 摘 述 为 Stat View， 没 有 办 法 区 分 它们 。 除 非 逐一 选中 ， 看 画布 中 高 之 的 是 
哪 一 个 。 在 Identity inspector 中 使 用 Document:lable 设 置 可 读 的 名 称 。 在 Identity Inspector 中 还 有 一 件 事 要 检查 : Modulehy 
该 是 GameDB; 这 融 是 视图 的 定义 。 


注意 (@UIDesignable 依 赖 于 Interface Buildet 构 建 和 执行 它们 的 类 的 泻 染 。 在 我 撰写 本 节 的 时 候 ，Xcode 还 不 可 靠 ; 
StatView.swift 的 编译 速度 不 够 快 ， 无 法 满足 IB 的 超时 要 求 ， 这 点 很 常见。 最 好 的 做 法 是 选中 其 中 的 一 个 ， 然 后 使 用 命令 


Editor— Debug Selected Views. 


你 的 速度 可 能 比 我 快 : 按 住 control 键 将 视图 元 素 拖 到 TodayViewController 中 ， 这 样 就 可 以 设置 它们 的 内 容 了 。 


import UIKit 
import NotificationCenter 
import GameDB 


class TodayViewController: UIViewController, NCWidgetProviding { 


@IBOutlet weak var passerNameLabel: UILabel! 
@TBOutlet weak var ratingLabel: UILabel1! 
@TBOutlet weak var attemptsStat: StatView! 
@ITBOutlet weak var completionsStat: StatView! 
@TBOutlet weak var yardsStat: StatView! 
@IBOutlet weak var touchdownsStat: StatView! 
@TBOutlet weak var interceptionsStat: StatView! 


var laggingFirstName = "" 
var laggingLastName = "" 


override func viewDidLoad() { 


super.viewDidLoad () 
£il1ViewContents () 


override func didReceiveMemoryWarning() { 
super.didReceiveMemoryWarning () 

// Dispose of any resources that can be recreated. 
// You must take this more seriously than you might 


func widgetPerformUpdatewithCompletionHandler 
completionHandler: ((NCUpdateResult) -> Void)!) { 
completionHandler (£i11ViewContents () ) 


func £fill1ViewContents() -> NCUpdateResult { 
// Pull Passer Rating's passer selection in from 
// the common preferences. The keys are defined in 
// GameDB.swift. 


let defaults = NSUserDefaults (suiteName: GameDBContainerKey) ! 
let selectedFirstName = defaults.stringForKey (GameDBPasserFirstKey) 
let selectedLastName = defaults.stringForKey (GameDBPasserLastKey) 


if selectedLastName == nil || selectedLastName == nil { 
return .Failed 


if selectedFirstName == laggingFirstName && 
selectedLastName == laggingLastName { 
return .NoData 


laggingLastName = selectedLastName! 
laggingFirstName = selectedFirstName! 


let passer = Passer.passerWithFirstName (selectedFirstName, 
last: selectedLastName) 


passerNameLabel.text = passer.fullName 


// ratingFormatter is an NSNumberFormatter that came in when 
// you transferred Utilities.swift to GameDB. 
ratingLabel.text = 
ratingFormatter.stringFromNumber (passer.passerRating) ! 


attemptsStat.value = passer.attempts 

completionsStat.value = passer.completions 

yardsStat.value = passer.yards 

touchdownssStat.value = passer.touchdowns 

interceptionsStat.value = passer.interceptions 
return .NewData 


iOS 会 在 container apps (容器 应 用 ) 中 安装 扩展 ， 但 是 它们 会 在 hosting apps (宿主 应 用 ) 中 运行 。 在 扩展 的 行为 或 者 导 
出 中 可 以 很 容易 看 到 这 一 点 : 任何 App 都 能 显示 它们 ，App 必 须 配置 扩展 并 向 它们 传递 数据 。 当 你 执行 Product 一 Run 的 时 候 ， 
你 必须 在 Scheme 编辑 器 的 Executable 的 弹出 窗口 中 指定 宿主 应 用 ， 或 者 声明 想 让 Xcode 来 Ask on Launch。 


Today 挂 件 在 Notification Center 中 执行 ， 它 是 一 个 系统 级 的 工具 。 模 拟 器 使 用 了 一 个 特殊 的 进程 Today 作 为 宿主 应 用 。 
Today 并 没有 出 现在 Executable 菜 单 中 ， 所 以 我 们 使 用 Ask on Launch (确保 选中 了 Passer of the Day 这 个 target) 。 当 你 运 
行 挂 件 的 时 候 ， 模 拟 器 就 会 显示 Notification Center， 同 时 Today 挂 件 也 在 你 想 要 的 位 置 。 


你 可 以 像 对 待 其 他 应 用 程序 一 样 设置 断 点 和 调试 Passer of the Day。 因 为 ldb (Xcode 的 调试 器 ) 在 调试 的 时 候 能 将 多 个 进 
程 作 为 目标 ， 回 到 Xcode 中 。 选 中 Passer Rating scheme， 然 后 再 次 运行 。Debug 区 域 的 跳 转 栏 会 让 你 在 上 下 文中 切换 。 


还 有 更 多 功能 : 如 果 App 所 在 的 项 目 中 有 一 个 它 要 使 用 的 库 文 件 (静态 或 者 动态 ) , 那么 你 可 以 在 库 文件 中 设置 断 点 并 调 


试 。 完 全 不 用 专门 “局 动 ” 库 文件 (这 个 概念 没有 意义 ) 或 者 在 调试 的 时 候 指 定 库 文件 。 


o 


17.5 ”构建 依赖 


可 能 你 会 发 现 同 时 构建 Passer Rating 和 Passer of the Day 挂 件 不 太 容 易 ， 大 量 的 编译 错误 提示 没有 一 个 App 能 够 识别 
GameDB 符 号 ， 即 使 你 已 经 在 每 个 引用 GameDB 的 地 方 都 添加 了 import GameDB 这 条 指令 。 库 文件 的 修改 可 能 没有 直接 体现 
在 其 他 应 用 程序 中 。 


下 面 列 出 了 一 些 问题 : 
- 当 我 们 创建 了 POTD 和 GameDB target 的 时 候 ， 你 将 Passer Rating 作 为 容器 应 用 程序 。 


- Xcode A Passer Rating 修 改 了 构建 过 程 ) App 的 生成 需要 依赖 扩展 和 框架 。 在 Apb 的 Target 编 辑 器 中 Build Phases 选 项 卡 下 的 第 
一 部 分 可 以 看 到 这 个 修改 。 很 好 。 


同样 ，Xcode 在 Passer Rating 的 Link Binary With Libraries 阶 段 添加 了 GameDB.framwotk。 本 来 不 需要 这 个 操作 ， 不 过 也 还 好 。 


- Xcode 从 来 没有 询问 Passer of the Day 是 否 要 依赖 于 GameDB.framewoftk， 所 以 它 没 有 出 现在 POTD 的 (link-with-libratries) 链 


接 库 阶段 ， 但 是 如 果 你 导入 一 个 模块 ， 构 建 需 提供 会 默默 地 将 对 应 的 库 添 加 到 链接 阶段 。 很 好 。 


- Xcode 没有 解决 的 是 POTD 依 赖 于 GameDB.framewoftk。 当 框架 发 生 修 改 的 时 候 ， 没 有 设置 强制 重新 构建 扩展 。 这 是 一 个 问 


- Passer Rating 既 依赖 于 GameDB 也 依赖 于 POTD, 但 是 构建 系统 没有 保证 依赖 库 的 构建 顺序 Xcode 其 至 会 同时 构建 独立 
的 tareget。 既 使 App 构 建 同 时 更 新 了 两 个 target， 它 也 很 可 能 无 法 使 用 田 外 一 个 target 的 当前 版 本 。 这 一 点 很 糟糕 。 





你 必须 要 告诉 Xcode 依赖 关系 : 在 Target editor 中 选中 Passer of the Day 并 选中 Build Phases 选 项 卡 ， 单 击 Target 
Dependencies 阶 段 的 提示 按钮 ， 还 有 表 下 面 的 + 按钮 。 束 会 显示 一 个 列表 列 出 项 目 中 所 有 的 targets。 选 中 GameDB 并 单 击 Add 
按钮 。 


9 注意 不 要 将 Passer of the Day 作 为 GameDB.framewofk 的 依赖 。 首 先 ， 不 符合 区 辑 。 其 次 ， 本 来 你 应 该 先 构 建 
GameDB.framewotk， 然 后 才能 构建 Passer of the Day， 而 现在 GameDB.framewok 必 须要 在 Passet of the Day 之 后 运行 …… Xcode 将 会 
检测 到 循环 依赖 ， 所 以 拒绝 构建 。 和 仔细 想 想 实际 的 依赖 ， 如 果 你 的 确 有 循环 依赖 ， 那 需要 重 构 你 的 库 文 件 ; 这 不 仅仅 是 个 技术 问 


题 ， 更 是 一 个 糟糕 的 设计 问题 。 


17.6 结果 


当 一 切 准备 就 绪 后 ， 选 中 Passer of the Day scheme 和 一 个 iOS Simulator target， 选 择 Product 一 Run (ÆR) ， 然 后 将 


Today 进 程 作为 宿主 。 模 拟 器 应 该 显示 Notification Center 的 Today 选 项 卡 ， 其 中 包含 POTD， 见 图 17.4。 


Passer of the Vay 


Quinn Adams 145.5 
Attempts 11491 Touchdowns 1583 
Completions 8141 Interceptions 0 


Yards 123002 





图 17.4 完整 的 Passef of the Day 挂 件 ， 简 要 显示 了 Passet Rating 应 用 程序 中 最 后 选中 的 四 分 位 的 概况 ， 无 论 Passer Rating 是 否 正在 运 


行 都 可 以 显示 这 个 内 容 


从 屏幕 底部 向 上 滑动 ， 天 闭 Center， 局 动 Passer Rating (最 近 应 该 编译 过 与 挂件 兼容 的 Passer Rating) ， 在 起 始 界面 单 击 
一 个 passer。 再 次 打开 Notification Center。POTD 挂 件 应 该 显示 出 你 刚才 选中 的 passer 的 统计 信息 。 


17.7 小 结 
框架 是 Cocoa 开 友 的 基础 部 分 。 框 架 可 以 让 iOS 开 上 友 为 每 个 应 用 添加 系统 扩展 的 能 力 ， 同 时 还 能 让 其 他 应 用 使 用 它 提供 的 服 


务 。 


在 本 章 中 ， 你 看 到了 如 何 构建 一 个 Today 挂 件 ， 这 是 一 个 最 简单 的 扩展 。 我 们 看 到 了 扩展 如 何 借助 App Group 容 器 与 它 对 
应 的 应 用 程序 共享 数据 。 我 们 将 两 个 应 用 中 共享 的 功能 重 构 ， 生 成 了 一 个 共享 库 (CMER) ， 它 包含 了 可 执行 代码 和 数据 资 
源 。 


接 下 来 ， 我 们 要 学 习 如 何 将 应 用 程序 对 外 友 布 。 


第 18 草 ”配置 


简 而 言 之 ，Apple 不 想 让 一 款 不 信任 的 App 运 行 在 任何 一 台 iOS 设 备 中 ， 它 也 不 想 让 App 在 应 用 商店 以 外 自由 传播 。 在 App 
生命 周期 的 每 个 阶段 里 一 一 从 梨 面 测试 到 beta 测 试 ， 再 到 最 后 的 友 布 一 一 你 必须 要 突破 重重 障碍 。 

前 些 年 ， 这 个 过 程 非常 繁琐 : 你 不 得 不 管理 在 Mac 上 生成 的 两 个 誉 名 证 书 ， 然 后 将 这 个 釜 名 证 书 上 传 到 Apple 的 配置 管理 页 
H (provisioning portal) ， 等 网 站 处 理 这 个 证 书 ， 然 后 下 载 安 妆 到 钥匙 链 中 。 你 不 得 不 为 每 个 产品 都 注册 一 个 唯一 的 标识 符 
(identifier) ， 还 要 注册 每 个 想 要 调试 的 设备 。 从 应 用 程序 的 角度 来 说， 当 想 要 调试 、beat 测 试 或 者 友 布 到 应 用 商店 中 的 时 


候 ， 都 需要 请 求 “配置 文件 (provisioning profile) ”， 并 把 它们 安 六 到 Xcode 中 。 若 要 更 改 配 置 证 书 或 者 更 换 设 备 ? 那 束 重 
HER, Ask imac ct. 


在 这 个 过 程 中 ， 会 出 现 非 党 多 的 错误 ,没有 人 能 一 次 性 做 对 。 


随 着 Xcode 的 发 展 ， 越 来 越 多 的 工作 从 网 页 转移 到 了 Xcode 本 身 。 现 在 ， 这 个 过 程 基 本 上 是 透明 的 。 不 过 你 还 是 需要 明日 一 
些 基 本 的 规则 ， 在 发 布 App 之 前 ， Xcode 已 经 将 所 有 的 事情 都 处 理 完毕 。 


本 章 将 会 向 你 展示 与 标识 (identity) 有 关 的 3 方面 内 容 : 签名 、 应 用 程序 和 设备 。 标 识 将 会 用 于 把 iOS App 安 装 到 一 个 设备 
上 的 配置 文件 中 ， 以 及 如 何 将 这 些 标识 放 到 配置 文件 (provisioning profiles) 中 。 我 先 介 绍 iOS 应 用 程序 的 过 程 ， 然 后 再 介绍 
OS X 与 之 不 同 的 地 方 。 


18.1 Apple 开 发 者 计划 


想 要 把 App 安 委 到 设备 中 ， 首 先 要 获得 Apple 的 信任 ( 若 无 法 获取 Apple 的 信任 ,至少 也 要 明确 你 的 身份 ) 。 它 需要 你 的 名 
字 和 和 地址， 你 要 同意 许可 条 例 ， 并 支付 用 于 身份 确认 的 费用 。 想 要 继续 下 去 ， 需 要 加 入 iOS 开 友 者 计划 ( 当 我 撰写 本 书 的 时 候 ， 
美国 的 费用 为 一 年 $999) 。 


为 了 加 入 开发 者 计划 ， 请 浏览 http://developer.apple.com/， 单 击 大 大 的 iOS (或 者 Mac) Developer Program 图 片 ， 从 
这 里 开始 加 入 的 流程 。 有 一 种 快捷 的 方式 ,打开 Xcode Preferences 窗 口中 的 Accounts 面 板 ， 按 住 + 按钮 ， 然 后 选择 Add Apple 
IDhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...。 束 会 弹出 一 个 界面 ， 询 问 开 发 者 注册 用 的 
Apple ID 和 密码 。 不 过 上 面 也 有 一 个 Join a Programhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 按 钮 ， 能 让 你 直接 在 浏览 器 中 完成 注册 。 


18.1.1 通用 (App Store) 计划 
对 于 通用 的 iOS 和 Mac 开 发 者 计划 有 两 种 不 同 的 注册 机 制 |。 
Organizations 


Organization 是 具有 诸如 来 自 Dun&Bradtreet 信 用 评级 系统 给 出 的 DUNS 编 号 的 实体 。Apple 人 允许 它们 让 多 个 开 友 者 共用 
一 个 企业 账号 。 这 些 开发 者 按照 层级 管理 ， 不 同 层级 的 权限 不 同 。 


- Team Membetrs 可 能 会 因为 开发 目的 安装 App， 团 队 中 高 级 人 员 会 给 他 授权 。Membet 无 法 对 任何 事情 授权 ， 他 们 仅 能 向 
Admins 或 者 Agent 发 送 请 求 。 


- Team Admins 能 邀请 其 他 人 加 入 Organization 账 户 ， 对 开发 中 要 使 用 到 的 设备 进行 认证 ， 管 理 签名 证 书 ， 处 理发 布 配 置 文 
件 ， 批 准 来 自 Team Members 的 请 求 ， 并 能 完成 所 有 Team Members 能 完成 的 工作 。 


- Organization P 124% —7*Team Agent, 为 它 代 表 了 法 律 权 威 和 Otrganization 的 身份 。 它 负责 保持 会 员 计 划 的 高 标准 ， 查 看 和 


Individuals 


在 Individual 计 划 中 ， 开 友 者 的 注册 非常 简单 : 因为 只 能 有 一 个 人 使 用 账号 ， 所 以 个 人 开 友 者 扮演 着 Team Agent 的 角色 。 
不 需要 别人 授权 ， 也 没有 任何 限制 。 


18.1.2 ”企业 计划 


Apple 有 一 个 独立 的 针对 那些 用 于 企业 内 部 (in-house) 使 用 的 应 用 的 Enterprise 开 上 者 计划 。 参 加 这 个 计划 的 成 员 能 发布 
apps， 只 能 内 部 使 用 而 不 能 将 它们 通过 应 用 商店 发 布 。 这 些 apps 能 安装 到 无 数 台 设备 上 ， 不 过 这 个 配置 文件 每 3 年 必须 重新 生 
成 一 个 新 的 。Enterprises 计 划 中 的 角色 与 Organization 账 户 类 似 ， 它 也 包含 Members、Admins， 还 有 Adgents。 


Apple 的 B2B 计 划 还 提供 了 另外 一 种 在 组 织 内 上 友 布 应 用 程序 的 方法 ， 即 使 是 目 定 义 的 应 用 程序 版 本 也 能 用 。 组 织 不 需要 具有 
或 者 维持 Enterprise 成 员 天 系 ， 同 时 也 不 需要 洒 拙 地 让 外 部 开发 者 访问 Enterprise 认 证 。B2B 友 布 版 会 应 用 商店 中 发 布 ， 但 是 外 
界 大 众 看 不 到 这 个 App。 组 织 为 雇员 购 入 很 多 App， 这 些 雇 员 登 录 应 用 商店 账号 后 可 以 使 用 organization 给 予 的 兄 换 码 下 载 这 些 
应 用 。 这 惑 是 B2B 计 划 的 大 概 ， 详 见 http://developer.apple.com。 


18.2 1OS 的 配置 


下 面 束 是 iOS 配 置 的 过 程 ， 也 殊 是 将 Xcode 生成 的 应 用 安 闪 到 设备 中 。Xcode (一 般 ) 帮 你 隐藏 了 很 多 细节 ， 但 是 如 果 你 不 
知道 其 中 的 流程 ， 还 是 会 有 一 些小 情况 很 难处 理 。 


号 注意 OS X 的 配置 过 程 非常 相似 ， 除 了 当 你 将 应 用 程序 提交 到 应 用 商店 的 时 候 ， 你 必须 应 用 发 布 认证 和 安装 认证 。 


授权 安装 一 个 App 包 含 3 个 标识 。 





- Signatutre 一 一 app 必 须 经 过 开发 者 (或 者 如 果 是 通用 发 布 ， 那么 需要 Team Admin 或 者 Agent) 加 密 签名 ， 由 此 来 确认 开发 者 


计划 的 成 员 关 系 。 这 个 认证 表示 签名 标识 (signingidentity) 。Apple 会 生成 签名 认证 。 





- Application ID 它 标 识 了 特定 的 App ， 这 是 一 个 简单 的 字符 串 ， 通 过 域名 的 逆向 书写 来 确保 唯一 性 ， 你 需要 使 用 这 个 字 
符 串 在 Apple 中 注册 应 用 程序 。 这 个 字符 串 与 应 用 程序 中 Info.plist 里 面 的 包 ID 一 样 。 对 于 Passet Rating 来 说 ， 这 个 字符 串 就 是 


com.wt9t.Passer-Ratingo 





- Authorized device 应 用 商店 和 Enhtetptise 应 用 程序 能 安装 到 世界 上 任意 一 台 iOS 设 备 上 。 对 于 development 版 本 和 beta 版 本 
的 应 用 程序 ， 设 备 需要 在 Apple 上 注册 。 你 的 开发 者 计划 有 100 个 注册 名 额 ， 每 个 期 限 为 一 年 。 你 也 可 以 反 注 册 一 个 设备 ， 但 是 空 


出 来 的 这 个 注册 资格 在 你 的 开发 者 计划 到 达 一 年 之 前 无 法 使 用 。 


基于 这 些 原因 ，Apple 将 会 生成 一 个 配置 文件 (provisioning profile) 。 它 会 将 你 的 App ID、 一 个 或 者 多 个 授权 签名 者 以 
及 一 个 或 者 多 个 设备 绑 定 在 一 起 ， 放 到 一 个 包 中 ， 用 来 告知 jiOS 设 备 这 是 个 受信 和 任 的 应 用 程序 ， 可 以 安装 。 有 用 于 连 线 调试 的 开 
发 配置 ，beta 测 试 的 ad hoc 配 置 以 及 在 应 用 商店 中 发 布 的 发 布 配置 。 


SiR ”如果 为 组 织 开发 应 用 程序 ， 那 么 Ad hoc (beta) 发 布 可 能 会 遇 到 政策 问题 。100 台 设备 的 注册 名 额 是 一 个 有 限 的 资 
源 ， 必 须 妥 善 管理 。 如 果 不 注册 新 设备 ， 就 无 法 进行 开发 。 但 是 你 可 能 会 遇 到 来 自 CEO、 老 板 的 老板 、 老 板 的 老板 的 老板 等 的 
压力 ， 他 们 都 想 要 “测试 ”你 的 App， 但 他 们 只 不 过 是 想 在 他 们 的 朋友 面前 炫 沅 一 下 而 已 。 在 问题 出 现 之 前 ， 确 保 你 所 在 的 公司 
为 测试 和 开发 使 用 的 设备 注册 号 进行 妇 好 的 管理 。 


18.2.1 ”你 会 看 到 什么 


Xcode 6 几乎 自动 完成 了 所 有 工作 。 入 口 网 站 也 就 是 Certificates Identifiers&Profiles 还 在 那里 ， 它 基本 上 被 视 为 配置 信息 
的 控制 台 ， 也 被 当做 注册 的 一 个 的 额外 接口 ， 同 时 也 是 获取 友 布 配置 和 认证 的 唯一 接口 ， 登 
录 http://developer.apple.com/membercenter/ 就 能 访问 到 。 


SE Certificate ，Identifiefs&cPtofiles 是 一 个 很 繁琐 的 名 字 ， 所 以 我 会 将 它 称 为 pottal。 
注册 你 的 Team membership 


在 你 执行 任何 程序 开 友 相关 的 工作 之 前 ， 请 打开 Preferences 窗 口 选 择 Accounts 面 板 。 


Accounts 面 板 中 集合 了 3 种 类 型 网 络 服务 的 地 址 和 证 书 : Source-code 仓 库 ，Xcode Server 账 尸 ， 以 及 我 们 现在 关心 的 注 
册 开 上 者 的 Apple ID。 我 的 设置 已 经 足够 作为 一 个 民 好 的 例子 展示 ， 见 图 18.1。 


Accounts 


General At mts Gehaviors Navigation Fonts & Colors Text Editing Key Bindings Source Control Downloads Locations 














Apple IDs 


Apple ID 


Apple ID: 


ee Password: | sssess 
Repositories 


passer-rating Description: | Personal Dev Programs 


sshifort-knox.example.com/git’... 


passer-rating-6 
sshi/manoverboard.orggit‘pass... 


Fritz Anderson Agent 
The University of Chicago Admin 
The University of Chicago (ent) Admin 


uem-ios git 
httos:/iwe-git.uchicago.edu/stas... 


View Details... 


@ Fritz Anderson 
Personal Dey Programs 


Signing identites Plattorm Status 
OS Development ios Valid 
Developer ID Application Mac Walid 
Developer ID Installer Mac Valid 


Provisioning Profiles Expiration Entitlements 


MacTeam Provisioning Profile: * 10/17715 1 
MacTeam Provisioning Profile: com.wtSt.passer-ra.. TO/TTAIS | 
iOS Team Provisioning Profile: org.manoverboard.x... 10/17715 » 
iOSTeam Provisioning Profile: ~ 10/17/15 © 
iOSTeam Provisioning Profile: com.wt8t.Passer-Rating 10/17/15 
iOSTeam Provisioning Profile: com.wt9t." 10/17/15 + 


© 





图 18.1 %—~ Apple ID 账户 添加 到 Prefetences 窗 口 的 Accounhts 面 板 中 时 ， (上 ) Xcode 会 获得 所 有 与 这 个 ID 相 关 的 开发 者 计划 团 


队 。 (下 ) 选中 一 个 team membetship 然 后 单 击 View Details， 就 能 显示 这 个 team member 可 用 的 证 书 和 配置 文件 


想 要 添加 一 个 Apple ID， 只 需要 按 住 左 侧 列表 下 部 的 + 按钮 ， 然 后 在 下 拉 菜 单 中 选择 Add Apple 
IDhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...。 你 将 被 要 求 填写 用 于 开发 的 Apple ID, IKAR 
码 以 及 账户 摘 述 ， 这 样 你 残 能 在 列表 中 与 其 他 账户 区 分 开 来 。 


有 了 证 书 之 后 ，Xcode 束 会 登录 到 开 友 者 账户 ， 找 出 你 从 属 的 所 有 团队 ， 然 后 下 载 与 这 些 team membership 相 关联 的 全 部 
配置 文件 。 如 果 你 没有 安装 所 有 的 签名 证 书 ，Xcode 就 会 自动 请 求 并 安装 。 如 果 你 没有 Apple 的 中 间 签 名 证 书 (intermediate 
signing-authority certificates) ，Xcode 也 会 安装 它们 。 图 18.1 显 示 了 我 这 里 的 配置 。 


如 果 你 发 现 自 己 仍 然 缺 少 一 个 所 需 的 签名 证 书 ， 那 么 单 击 team-member 细 节 界 面 中 证 书 列 表 中 的 + 按钮 (图 18.1 下 ) ， 然 
后 选中 你 所 需要 的 证 书 类 型 。Xcode 就 会 应 用 这 个 证 书 ， 下 载 并 安装 。 


18.2.2 注册 你 的 App 


当 你 创建 了 一 个 iOS 项 目的 时 候 ，Target 编 辑 器 中 的 General 选 项 卡 就 会 表示 Xcode 不 知道 与 这 个 产品 相关 的 任何 产品 信 
息 。 为 了 获得 配置 ， 你 需要 成 为 开 友 者 计划 中 的 一 员 。 在 弹出 菜单 中 选择 一 个 team memberships。 如 果 你 没有 一 个 
membership 或 者 不 为 任何 人 工作 ， 那 么 你 也 可 以 不 选 (None) 。 人 否则 ，Xcode 可 能 不 知道 你 是 Apple 的 注册 开 友 者 。Add an 
Accounthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 将 会 打开 Preferences window 中 的 Accounts 面 
板 处 理 相关 事宜 。 


STR ”这 些 术语 可 能 有 些 混乱 。 一 个 program member (计划 成 员 ) 是 一 个 人 或 者 组 织 花费 了 $899 用 来 访问 应 用 商店 、 配 置 
文件 、 预 发 布 的 软件 等 。 每 个 开发 者 计划 中 的 一 员 都 有 一 个 team (团队 ) 。Individual-program 成 员 将 它们 视 为 一 个 人 的 团队 。 
Otganization 中 的 团队 成 员 都 会 按照 我 在 本 章 开 头 讨论 的 层级 分 布 。 一 个 mete registered developer (仅仅 是 注册 了 的 开发 者 ) 没有 
Applet R; 他 仅仅 是 单 击 了 Registet 连 接 跳 转 到 了 developet.apple.com 页 面 。Apple 取 得 了 他 的 Apple ID， 他 也 同意 了 服务 条 款 。 


mete registered developert 不 属于 任何 团队 ,但 是 organizational program membets 能 邀请 他 加 入 。 


选择 团队 为 Xcode 提 供 了 另外 一 个 服务 机 会 。 现 在 Xcode 知 道 这 个 产品 属于 哪个 program membership, tcompany 
identifier (公司 标识 符 ) 和 创建 target 时 填写 的 product name (产品 名 称 ) 组 合成 Bundle Identifier ( 包 标 识 符 ) 。Xcode 和 
Apple 知 道 签名 标识 用 于 所 有 的 团队 成 员 ，application ID 以 及 团队 中 所 有 注册 的 设备 。 这 就 是 生成 配置 文件 的 3 个 前 提 : Xcode 
向 Apple 请 求 用 于 App 的 Team Provisioning Profile (团队 配置 文件 ) 一 一 用 于 识别 团队 中 每 个 开发 者 的 证 书 一 一 并 将 它 安装 
到 设备 中 。 当 做 完 这 一 切 之 后 ， 整 个 团队 都 得 到 了 将 App 安 装 到 任何 一 个 已 注册 用 于 调试 的 设备 中 的 权限 。 


你 这 你 的 设备 还 没有 注册 ”将 设备 连 上 计算 机 ， 确 保 它 能 信赖 你 的 计算 机 ， 然 后 找到 Devices 浏 览 
器 ，Window 一 Devices (%#1) 。 选 择 最 上 面 的 一 个 设备 ， 然 后 单 击 主 视图 中 的 Enable for Development 按 钮 。Xcode 就 会 
询问 哪个 团队 要 注册 这 个 设备 (你 可 以 选择 多 个 ) 。Xcode 会 在 设备 (Settings 一 Developer， 应 用 程序 上 面 的 面板 ) kR 
(或 者 显示 ) 一 些 性 能 调试 工具 ; 如 果 Xcode 没 有 设备 上 运行 的 OS 版 本 的 符号 ， 那 么 它 就 会 下 载 对 应 的 符号 ， 并 用 选中 的 团队 
注册 设备 。 已 授权 设备 更 改 列表 意味 着 配置 文件 的 更 改 ， 所 以 Xcode 会 重新 下 载 所 有 受 影响 的 配置 。 


四 注意 有 两 种 类 型 的 team provisioning ptofile。 一 种 标准 的 形式 是 application ID 中 包含 *， 这 就 意味 着 它 会 授权 所 有 的 应 用 
程序 。 很 长 的 一 段 时 间 内 ， 它 是 唯一 的 团队 配置 文件 。 现 在 ， 访 问 Apple 的 云 服 务 就 能 授权 每 个 应 用 程序 的 标识 符 。 使 用 这 些 服 
务 的 应 用 程序 不 得 不 有 针对 这 些 标识 符 特 殊 的 配置 。 它 们 仍然 被 称 为 team profiles (团队 配置 文件 ) ， 因 为 它们 拥有 整个 开发 者 
标识 和 注册 设备 的 名 单 。 


你 还 记得 ， 如 果 你 是 一 个 mete Membet， 你 没有 权限 注册 设备 或 者 应 用 程序 标识 ， 甚 至 无 法 自己 解决 开发 签名 证 书 的 问题 。 
那么 配置 系统 将 会 发 送 邮件 给 Admins 和 Agent， 让 他 们 批准 你 的 请 求 。 当 他 们 批准 了 你 的 请 求 之 后 ， 单 击 team-membet 详 细 界 面 中 


的 圆圈 中 包含 一 个 箭头 的 按钮 Xcode 就 会 刷新 信息 (图 18.1 下 ) o 


Sits 在 有 些 情况 下 





尤其 是 对 beta (adhoc) 用 户 来 说 将 设备 插 到 计算 机 上 与 Xcode 连接 在 一 起 似乎 不 太 实 际 。 





那么 这 些 设备 就 要 在 入 口 网 站 中 手动 输入 。 进 入 网 站 ， 选 中 iOS 部 分 (如 果 有 多 个 选项 ) ， 然 后 在 左 侧 的 列表 中 选择 Devices 部 
分 。 单 击 + 按 钮 ， 输 入 设备 的 别名 和 它 的 UID， 它 是 一 个 40 个 字符 的 十 六 进 制 字符 串 ， 能 唯一 地 确定 设备 。Devices ofganizet 在 显 
着 位 置 显 示 了 UDID， 不 懂 技 术 的 用 户 可 以 将 设备 插入 iTunes 中 ， 选 中 插入 的 设备 ， 然 后 单 击 序列 号 的 位 置 ， 那 里 就 会 显示 出 


UDID。 这 段 文本 无 法 选取 ， 但 是 通 第 Copy 手 势能 将 这 段 字 符 串 粘贴 到 剪 切 板 中 ， 所 以 用 户 能 将 这 个 UDID 用 邮件 发 送 给 你 。 


18.2.3 ”保护 资源 


这 里 涉及 很 多 工作 ， 即 使 你 不 需要 亲自 做 很 多 工作 。 仪 需要 在 Accounts 面 板 中 添加 相同 的 accounts 然 后 重新 输入 你 的 证 
就 能 恢复 或 者 从 另外 一 台 机 器 上 重新 获得 。 


出 


但 是 有 一 部 分 内 容 Apple 和 Xcode 没有 帮 你 恢复 : 经 过 公 钥 / 私 钥 加 密 的 签名 证 书 。Xcode 会 为 每 个 证 书生 成 一 个 专 有 的 私 
钥 。 正 如 名 字 所 述 ， 它 是 私密 的 。Apple 不 知道 这 个 私 钥 。 它 只 存在 于 你 的 钥匙 链 中 : 在 Keychain Access 应 用 程序 的 

login 一 Certificates 部 分 能 得 看 到 这 个 私 铀 。 如 果 一 个 证 书 旁 边 有 个 提示 和 荫 头 ， 单 击 融 能 看 到 私 铜 。 事 实 上 ， 这 是 查看 缺失 的 私 
钥 的 好 万 ;去 ， 丢 失 私 钥 经 党 会 导致 代码 签名 问题 。 


如 果 这 个 私 钥 丢 失 了 ， 那 束 是 丢失 了 ， 无 法 挽回 。 唯 一 的 解决 方法 就 是 撤销 这 个 认证 ， 然 后 生成 一 个 新 的 私 钥 ， 这 会 影响 所 
有 依赖 于 这 个 私 钥 的 应 用 程序 ， 它 们 将 无 法 工作 。 但 是 已 经 在 应 用 商店 中 上 架 的 应 用 程序 不 受 影 响 。 


所 以 ， 请 备份 这 个 私 铀 。 在 Keychain Access 中 选中 证 书 ， 并 选择 File 一 Export 
ltemshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (0HE) 来 保存 这 个 钥匙 对 。 但 是 Xcode 能 做 得 
更 好 。 在 Accounts 面 板 中 ， 选 择 Export Accountshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 它 在 列表 底部 设置 按钮 的 菜单 中 。Xcode 将 会 
引导 你 加 密 所 有 资源 文档 。 把 这 个 私 钥 放 在 一 个 安全 的 地 方 ， 不 要 和 开发 机 器 放 在 一 起 。 


STR 如 果 你 将 签名 证 书 给 “开放 ”项 目的 开发 者 使 用 ， 那 就 等 着 Apple 收 回 这 个 证 书 并 且 将 你 拖 入 开发 者 计划 的 黑 名 单 


中 吧 。 用 于 开发 者 证 书 的 个 人 账号 是 交易 的 一 部 分 。 


18.2.4 提交 iOs 应 用 程序 
Apple 将 安装 到 iOS 设 备 的 应 用 程序 进行 了 分 类 。 


Development 是 载 入 调试 应 用 程序 的 过 程 。 它 是 设备 、 开 友 者 和 调试 器 之 间 的 交互 活动 。 对 于 开发 者 来 说 ， 他 需要 一 个 开 
REAL. 


Distribution} hJ eA biga Maze BWA ERAS. XSW TUERSE RETA IL RAR. 


>E ”为 了 让 disttibution 这 个 词 表示 的 目的 更 明确 ， 多 年 来 经 常会 使 用 它 的 同义词 。 为 了 这 个 目的 ， 签 名 认证 有 一 个 统 
一 的 名 字 叫 作 iPhone Distribution。 指 向 这 些 证 书 的 入 口 是 Production。 以 构建 配置 (实际 上 ， 你 可 能 有 多 个 ) 为 目的 的 称 为 
Release。 创 建 一 个 发 布 包 的 常见 方法 是 执行 Archive 构 建 操 作 ， 它 会 生成 一 个 文档 包 (archive) ， 所 以 这 个 过 程 可 能 就 叫 作 


archiving. 
In-House Betas 


当 应 用 程序 开发 的 差不多 ， 需 要 不 使 用 Xcode 的 测试 者 测试 的 时 候 ， 束 可 以 创建 一 个 Ad hoch, Ad hoc 友 布 可 以 安装 到 任 


何 设备 上 ， 只 要 在 团队 中 注册 过 即 可 。 


它们 也 可 以 通过 iTunes 安 装 ， 但 是 最 常见 的 方式 是 over-the-air (OTA) 安装 。 这 些 设备 应 该 遵循 itms-services: URL, 
URL 会 指向 一 个 清单 文件 ， 其 中 包含 应 用 程序 包 (.ipa) 本 身 ， 还 有 类 似 描 述 和 下 载 图 标的 资源 。 这 些 资 源 可 以 放 在 任何 HTTPS 
服务 器 上 。 


企业 友 布 密切 相 天 。 不 同 之 处 在 于 应 用 程序 可 以 安 闪 到 任何 设备 上 ， 而 不 仅仅 局 限于 注册 的 那些 ; 许可 要 求 你 必须 严格 限制 


只 能 组 织 内 部 人 员 访 问 。 


早期 的 Xcode 版 本 会 帮助 你 制作 ad hoc 和 和 Enterprise 友 布 版 ， 但 你 保存 发布 .ipa 的 时 候 ， 它 会 收集 清单 使 用 的 URL 和 文本 。 
现在 Xcode 已 经 不 再 这 样 做 了 。 清 单 只 是 属性 列表 (.plist， 见 第 23 章 ) 文件 ， 话 细 襄 明 可 以 在 Internet 或 者 老 Apple 文 档 中 找 


到 。 


Apple 当 前 的 重点 在 Mobile-Device Management (MDM) 系统 ， 用 于 友 布 Ad hoc 和 Enterprise 应 用 程序 。iOS 使 用 的 
MDM 有 很 多 优点 ， 其 中 包含 应 用 商店 ， 比 如 这 你 想 要 上 友 布 的 应 用 程序 所 述 的 分 类 ， 还 有 更 新 的 提示 信息 。 还 有 一 些 其 他 商业 机 
构 会 提供 MDM 服 务 ， 或 者 最 简单 的 万 法 ， 你 可 以 使 用 Xcode Server 提 供 的 Profile Manager 处 理 注册 、 托 管 、 区 分 目录 和 推 

Apple 保 证 会 中 止 那些 非 测试 目的 的 使 用 Ad hoc 及 布 ， 或 者 在 许可 组 织 外 部 使 用 in-house 发 布 版 本 。 牢 记 这 一 点 。 


TestFlight Beta Distribution 


Beta 友 布 是 一 项 新 内 容 。Apple 现 在 提供 了 一 种 服务 TestFlight， 它 能 使 用 应 用 商店 发 布 系 统 将 beta 版 本 的 软件 友 送 给 1000 
位 测试 者 。 你 要 做 的 残 是 提供 测试 者 的 邮件 ， 测 试 者 要 做 的 残 是 在 他 们 的 设备 上 安 妆 TestFlight。 这 个 应 用 程序 将 会 管理 程序 下 
载 ， 并 且 当 你 友 布 新 版 本 的 时 候 ， 它 们 也 能 随时 保持 更 新 。 


Apple 还 需要 一 些 控制 : 应 用 商店 存在 的 意义 之 一 就 是 Apple 必 须 确保 它 的 用 户 不 会 受到 恶意 软件 的 侵害 。 想 象 一 下 ， 如 果 
一 个 恶意 软件 提供 商 邀 请 了 1000 个 人 来 体验 他 所 谓 的 好 玩 的 游戏 ， 但 实际 上 这 个 游戏 中 存在 一 个 密码 记录 器 ， 这 将 是 多 么 可 怕 
的 一 件 事 。 


所 以 ， 你 必须 像 提 交 公 开 应 用 一 样 提 交 beta 版 本 的 应 用 程序 。 不 同 之 处 在 于 : 


` 按照 一 个 全 新 的 (如 果真 的 是 全 新 的 ) 或 者 已 经 存在 的 软件 的 更 新 版 本 在 iTunes Connect 中 注册 你 的 应 用 程序 ， 不 过 要 指 
明 它 是 预 发 布 版 本 。 预 发 布 注册 非常 快 ， 因 为 它 不 需要 为 应 用 商店 提供 特定 的 元 数据 ， 而 且 测 试 版 本 提交 的 位 置 是 TestFlight， 
而 不 是 应 用 商店 。 当 前 商店 中 的 版 本 不 受 影响 。 


注册 时 在 预 发 布 的 版 本 中 添加 了 beta 测 试 权 限 ， 提 示 iOS 运 行 时 能 连接 到 它 记 录 日 志 ， 生 成 报告 和 更 新 服务 。 
` 你 需要 一 个 新 的 应 用 程序 发 布 配 置 文件 副本 ， 它 要 能 反映 出 beta 权 限 。 在 Accounts 偏 好 面板 中 刷新 配置 文件 将 会 得 到 它 。 


` 像 之 前 一 样 构 建 和 打包 应 用 程序 。 在 打包 后 的 文件 上 应 用 Validatehttp://www.hzcoutrse.com/tresoutce/readBook? 
path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/... 和 Submithttp://www.hzcourse.com/tresoutce/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... 操 作 ， 与 生成 产品 的 发 布 版 一 样 ( 见 本 章 后 面 “ 构 建 一 
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: Apple 将 会 查看 应 用 程序 中 是 否 包含 恶 意 代码 或 者 其 他 令 人 讨厌 的 内 容 。 如 果 没 有 发 现 恶 意 内 容 ， 它 就 会 提交 测试 版 本 并 


发 送 你 的 邀请 。 


TestFlight 应 用 程序 承担 了 下 载 和 更 新 推送 工作 ， 还 会 为 你 收集 日 志和 用 户 反 馈 。 


SITE Apple 在 TestFlight 名 称 下 提供 了 另外 一 项 internal 服 务 。 它 能 通过 无 线 的 方式 向 最 多 25 位 测试 者 提供 服务 ， 一 次 可 以 
同时 连接 10 台 设备 ， 只 要 它们 都 是 用 iTunes Connect 注 册 。 作 为 组 织 的 一 部 分 ， 同 时 这 项 服务 也 有 足够 的 权限 让 你 拒绝 不 信任 的 
用 户 。 

TestFlight 并 不 是 每 次 测试 唯一 的 选择 。 严 格 来 说 ，beta 的 意思 是 : 功能 完成 ， 对 那些 知道 App 用 途 的 用 户 来 说 可 以 使 用 ， 
这 些 人 不 需要 了 解 应 用 程序 的 构建 。 


Beta 版 本 的 应 用 程序 不 应 广 功 能 不 全 、 有 已 知 问题 或 者 包含 其 他 开 皮 者 和 产品 经 理 能 够 解决 的 问题 ， 一 般 用 户 不 应 该 看 到 
这 些 问题 。 出 于 这 种 目的 ， 请 发 布 Ad hoc 版 本 。 即 使 你 是 一 位 独立 开 上 友 者 ， 你 也 可 以 注册 朋友 的 设备 ， 这 样 他 们 融 可 以 帮助 你 
测试 。 


18.3 ”功能 编辑 器 


上 面 我 已 经 介绍 了 发 布 一 款 应 用 程序 时 至 少 要 知道 的 注册 和 认证 相关 的 知识 。 还 有 一 些 额外 的 功能 需要 认证 组 合 以 及 Apple 
持续 的 支持 ; 或 者 需要 在 应 用 程序 的 Info.plist 中 声明 ( 详 见 第 22 章 ) ;或 者 在 权限 文件 中 声明 ;或 者 链接 到 额外 的 系统 框架 
中 。 


Xcode 6 在 Target 编 辑 器 的 Capabilities 选 项 卡 下 提供 了 一 个 统一 的 编辑 器 ， 用 于 选择 常见 的 功能 。 每 个 功能 都 有 一 个 开 / 关 


按钮 。 单 击 旁 边 的 提示 三 角 就 会 显示 出 对 应 的 功能 描述 ， 以 及 Xcode 将 会 如 何在 产品 中 开启 这 个 功能 。 部 分 功能 还 有 更 多 选项 。 


18.3.1 OS X 独 有 的 功能 


所 有 OS X 上 可 以 使 用 的 功能 同样 适用 于 iOS， 除 了 一 个 : App Sandbox。 这 其 中 有 很 长 的 故事 ， 在 18.4 节 中 我 将 会 详细 解 


18.3.2 iOS 和 OS X 中 都 有 的 功能 


剩 下 的 6 个 OS X 功 能 也 同样 适用 于 iOS: 


. iCloud 是 针对 用 户 Apple 设 备 的 共享 存储 服务 器 。 开 启 这 个 功能 会 在 Apple 中 注册 功能 请 求 ， 同 时 将 存储 标识 放 到 权限 文件 


- Game Centet 是 Apple 自 带 的 用 于 排行 榜 和 玩家 竞争 的 中 间 件 。 如 果 要 使 用 Game Centetr，Xcode 会 注册 你 的 应 用 程序 。 注 意 
Info.plist 中 需要 添加 GameKit， 然 后 将 GameKit.framewotk 链 接 到 应 用 程序 中 。iOS 应 用 程序 会 自动 注册 Game Center,， 但 是 你 必须 


要 开 居 这 项 功能 才能 使 用 。 另 外 ， 必 须 登 录 iTunes Connect (itunesconnect.apple.com) 中 获取 应 用 程序 所 需 的 证 书 。 


- In-App Purchase 能 让 你 在 应 用 程序 内 部 售卖 服务 。 它 对 售卖 的 类 型 有 些 限制 ， 详 情 请 查看 审查 指南 和 IAP 文 档 。 拨 动 开关 
链接 StofeKit.framewotk ， 并 在 Apple 注 册 的 时 候 添 加 IAP。 你 可 能 仍然 需要 使 用 iTunes Connect 注 册 你 的 LAP 产 品 。 


- Keychain Shating 会 让 你 的 应 用 程序 通过 通用 钥匙 链 共 享 证 书 。 每 个 应 用 程序 都 必须 在 权限 文件 中 列 出 每 个 应 用 程序 的 标识 


符 。 这 个 选项 会 让 你 管理 钥匙 囊 列表 。 


Maps 功 能 在 两 个 平台 上 有 些 不 同 。 在 OS XP 
| 显示 地 图 ; 这 人 


这 个 功能 可 以 让 你 的 应 用 程 
亚特兰大 的 有 轨 电 车 和 渡 革 


链接 MapKit 框 
作为 第 用 的 应 用 程序 


沙 箱 政策 


的 组 ID 可 以 通过 Developet Relations 刷 新 ， 就 像 刷 新 配置 文件 那样 。 
18.3.3 10OS 功 能 


一 一 
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- App Gtoups 必 须 使 用 应 用 程序 ID 注册 。 共 享 组 标识 符 的 应 用 程序 


， 并 声明 显示 地 图 的 权限 。 所 有 的 1OS 应 用 程 
HEZ 


通 运输 的 组 
9 简单 版 本 。 使 用 反 DNS 的 形式 添加 ID， 开 头 是 group.com.wt9tfootball。 


AB AA AL 
所 以 你 可 以 专门 研究 
需要 访问 通用 文件 ， 并 且 文 件 之 间 可 以 相互 通信 ， 它 可 以 
.COm. 通过 Apple 注 册 容 器 ， 团 队 
务 器 推送 更 改 (假设 航空 公司 在 飞机 起 飞 前 售卖 了 一 张 飞机 票 ， 在 登 机 前 就 会 
能 ， 并 在 权限 文件 中 也 添加 权限 信息 ; PasserKit.framewortk 也 
添加 对 应 的 权限 


- Passbook 是 在 用 户 的 屏幕 上 显示 条 形 码 和 优惠 券 的 系统 。 开 启 了 Passbook 的 发 布 者 会 集中 管理 票据 ， 并 通过 Apple 的 推送 服 


BR ye 


aS 


使 用 Apple 注 册 应 用 程 厅 
. Personal VPN 允 许 应 用 程序 配置 和 提供 VPN 服 务 
中 这 个 功能 链接 NetworkExtension.framework 


pp 


推送 座位 信息 nm = 序 的 I) 
添加 到 链接 阶段 。 
- Apple Pay 可 以 通过 Apple 的 支付 系统 为 实体 商品 或 者 服务 付款 。 使 用 Apple 声 明 这 个 功能 和 所 


Inter-App Audio z— 3 特殊 的 服务 ， 它 允许 一 个 应 用 程 
激活 这 个 功能 ， 将 它 添 加 到 应 用 程 友 
H FEA 


的 标识 符 ， 并 在 权限 文件 中 
- Background Modes 可 以 为 一 个 周期 运行 


。 它 需要 通过 Apple 注 册 相 应 的 功能 ， 并 在 权限 文件 中 声明 相关 的 权限 
在 MIDI 命 令 和 语 
序 的 权限 文件 中 ， 同 时 链接 AudioToolbox.ftamewotk , 
序 必须 在 Info.plist 中 声明 你 想 要 的 服 


充 之 间 相 互 转换 。 在 Apple 中 注册 相应 的 权限 
通过 它 能 共享 很 长 的 故事 。 
的 后 人 台 程 序 提供 权限 选择 的 复 选 框 。iOS 仅 允许 后 人 台 应 用 程序 声明 特定 的 权限 。 应 
Apple 审 查 者 将 会 检查 应 用 程序 执行 的 操作 是 否 与 声明 的 权限 一 致 。 
Associated Domains。 一 个 1OS 应 用 程序 可 能 会 使 用 HTITTP/HTTPS 服 务 器 声明 一 个 特殊 的 关系 ， 它 会 列 出 服务 器 的 域名 作为 
相关 的 域名 。 这 个 功能 的 一 项 用 途 可 能 是 Handoff: Mac 用 户 正在 浏览 apple.com 中 的 一 个 网 页 ; 主机 没有 什么 特别 的 ， 所 以 一 个 
handoff 浏 览 任务 就 是 简单 地 打开 Safari 指 向 相同 的 URL 
设 你 有 一 项 天 气 服 网 页 和 iOS App 都 可 以 使 用 。 应 用 程序 
览 器 中 相同 的 雷达 显示 (有 一 些 保护 措施 可 以 防止 应 用 程序 访问 其 他 应 用 程序 
这 个 功能 将 会 列 出 相关 的 域名 ， 前 级 
HomeKit 是 Apple 提 供 的 框架 
冻 、 采 光 等 功能 。HomeKit 会 让 家 庭 
者 将 


是 你 选择 的 关键 词 ， 描 述 应 用 程 
， 使 用 它 可 以 将 应 用 程序 
庭 “用 户 » c> 
其 他 应 用 提供 的 操作 分 组 。HomeKit 应 用 可 以 通过 Sifi 控 制 
- 所 有 的 路 应 用 程序 


序 可 以 声明 一 个 与 网 站 域名 相关 联 的 关系 ， 局 动 后 
的 页 面 ) 。 
会 执行 


接 HomeKit 框 


示 与 浏 
的 应 用 
注册 ， 并 将 家 中 的 房间 和 区 域 

Xie i 
通信 和 跨 设备 管 


TŽ. żŽ 
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后 为 用 户 提 供 特 定 房间 所 有 的 管理 功能 ， 
理 都 通过 iCloud。 开 启 这 个 功能 需要 声 

- Data Protection 表 示 应 用 程序 所 有 的 文档 访问 都 应 该 按照 一 个 等 

定 设备 禁止 对 文件 的 访问 ， 即 使 你 已 经 打开 了 这 个 文件 ) ， 

态 ， 那 么 就 能 一 直 访 问 这 个 文件 ) ; 


或 
明 对 应 的 权限 ， 注 册 你 的 应 用 程序 


To 


等 级 或 者 另外 一 个 等 级 加 窗 
或 者 Complete Until First Login (È 


同时 还 要 链 
窗 。 保 护 的 等 级 应 该 是 完整 的 ( 锁 
Complete Unless Open ( 当 设 备 锁定 的 时 候 ， 如 果 文 件 处 于 打开 状 
动 后 当 用 户 第 一 次 角 
的 入 口 网 站 的 权限 列表 中 制定 这 些 等 级 


一 次 解锁 设备 时 文件 变 得 可 读 ) 
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. HealthKit 是 设备 上 应 用 程序 共享 的 一 个 安全 数据 库 。 它 们 可 以 交换 信息 ， 所 以 一 个 应 用 程序 可 以 追踪 行走 距离 ， 另 外 一 个 
可 以 记录 一 日 三 餐 ， 还 有 一 个 能 记录 能 量 的 摄 入 与 消耗 。iOS Health 这 个 应 用 程序 提供 了 一 个 共享 的 控制 面板 ， 它 会 收集 、 展 示 


并 保护 数据 库 中 的 内 容 。 
` 这 个 功能 需要 声明 相关 的 权限 ， 在 Apple 中 注册 ， 并 且 还 要 开局 设备 本 身 的 相关 功能 。 


- Wireless Accessory Configuration Apple 将 iOS 设 备 及 其 附件 (包括 AirPlay 和 其 他 一 些 HomeKit 设 备 ) 之 间 的 通信 系统 称 为 
MiFi。 附件 制造 商 可 以 在 https://developet.apple.com/programs/mfi/ 这 个 网 站 注册 ， 获 取 相 应 的 说 明文 档 和 支持 。 在 设备 这 一 


方 ，Wireless Accessory Configuration 权 限 允 许 应 用 程序 与 特定 的 MiFi 设 备 连 接 。 


18.4 OS X 沙 箱 
iOS 有 一 个 严格 的 限制 ， 所 有 的 App 都 应 该 处 于 sandbox ( 沙 箱 ) 中 ， 在 这 个 环境 中 ，App 无 权 访问 应 用 程序 包 外 的 文件 或 
者 不 是 本 应 用 程序 创建 的 文件 ， 也 不 允许 使 用 OS 许可 以 外 的 设备 服务 。 


OS X 10.7 Lion 在 Mac 中 引入 了 沙 箱 的 概念 ， 大 多 数 应 用 程序 都 可 以 使 用 沙 箱 ， 并 且 强 制 要 求 在 Mac 应 用 商店 中 售卖 的 App 
都 使 用 沙 箱 。 如 果 不 通 过 App Store 和 售卖 App， 那 么 你 将 无 权 使 用 Apple 的 服务 ， 如 iCloud 或 者 Game Center， 并 且 如 果 不 使 用 
沙 箱 就 无 法 放 到 应 用 商店 中 售卖 。 


使 用 阔 箱 的 思想 源 于 : 通过 禁止 开 友 者 没有 声明 过 的 服务 ， 他 人 残 难 以 攻击 用 尸 的 Mac 系 统 。 如 果 你 的 应 用 程序 没有 使 用 
网 络 的 需求 ， 而 你 的 应 用 程序 突然 访问 了 网 络 ， 那 么 肯定 (理论 上 说 ) 是 因为 你 的 应 用 程序 存在 某 些 缺 陷 被 恶意 软件 攻击 了 。 


默认 情况 下 ， 沙 箱 完 全 与 外 隅 绝 ， 除 了 直接 与 用 户 进 行 交互 。 它 甚至 无 法 读 写 文件 。 所 有 的 例外 情况 你 都 需要 在 App 的 权限 
文件 中 声明 。 你 必须 对 应 用 程序 进行 签名 (对 于 在 应 用 商店 中 上 架 的 应 用 程序 ，Apple 必 须 共同 签名 ) 防止 应 用 程序 被 更 改 。 
在 .entitlements 文 件 ( 它 按照 属性 列表 的 格式 组 织 ， 详 见 第 23 章 ) 中 声明 你 需要 的 权限 。 构 建 过 程 中 会 将 这 个 文件 嵌入 签名 的 
应 用 程序 二 进 制 数据 中 。 


Target 编 辑 器 中 的 Capabilities 选 项 卡 为 你 提供 了 一 些 常用 权限 的 复 选 框 。 当 你 开启 了 沙 箱 功能 后 ，Xcode 就 会 在 应 用 程序 
的 target 中 添加 一 个 your-app-name.entitlements (以 你 的 应 用 程序 名 开头 的 entitlements) 文件 列表 。 选 项 如 下 所 示 : 


- Network (网 络 ) 

- Incoming connections (Server) 连 入 的 网 络 (服务 器 ) 
- Outgoing connections (Client) 连 出 的 网 络 (客户 端 ) 
- Hardware (硬件 ) 

- Camera (相机 ) 

- Microphone (7f ) 

- USB 

- Printing (打印 ) 


- Apps (Æ MRF) 


- Contacts (通信 录 ) 

- Location (地 点 ) 

- Calendar (日 历 ) 

- No Access, Read Access 或 者 Read/Wtite Access: 
- User-selected file (用 户 选择 的 文件 ) 

- Downloads folder (下 载 的 文件 夹 ) 

- Pictures folder (图 片 文件 夹 ) 

- Music folder (音乐 文件 夹 ) 

- Movies folder (电影 文件 夹 ) 


9 注意 ”有 很 多 沙 箱 权 限 。 其 中 一 些 模糊 不 清 (理所当然 的 权限 或 者 明显 允许 的 权限 ) ， 比 如 访问 AppleScript， 共 享 偏好 
设置 或 者 具有 相同 基本 名 称 的 文件 都 被 视 为 用 户 在 相同 文件 夹 下 已 被 授权 。 还 有 一 些 属 于 tempotaty exceptions (临时 权限 ) ， 这 
意味 着 Apple 仍 然 在 寻找 如 何 实现 这 些 权 限 ; 或 者 意味 着 Apple 最 后 可 能 会 关闭 这 些 权 限 ， 但 是 为 了 让 开发 者 找到 合适 的 解决 方 
案 ， 暂 时 开放 。 还 有 一 些 可 能 需要 你 自己 去 搜 取 ， 布 望 〈 通 种 会 失望 ) Apple 审 查 者 能 够 为 沙 箱 开 启 一 些 你 的 应 用 程序 独占 的 权 
限 。 在 Documentation organizer 4% K Entitlement Key Reference， 在 开发 者 论坛 http://devforums.apple.com 中 发 帖 询问 ， 梳 理 


WWDC 视 频 。 这 可 能 是 为 数 不 多 的 几 个 使 用 率 超过 Stack Overflow 的 论坛 。 


如 果 你 想 要 在 App 的 沙 箱 目录 外 读 取 或 者 写 入 文件 ， 那 么 要 注意 ， 你 必须 先 获 得 相应 的 权限 。 即 使 这 样 ， 你 也 只 能 访问 显示 
指定 的 那些 文件 。 你 可 以 将 文件 拖 放 到 Finder 或 者 dock 中 应 用 程序 的 图 标 上 ;或 者 拖 入 应 用 程序 的 一 个 窗口 中 (如果 你 处 理 了 
文件 拖 放 操作 ) ; 或 者 通过 PowerBox (之 所 以 这 样 命名 是 因为 ….. 它 像 一 个 盒子 ) ，OS X 会 将 这 些 操作 都 视 为 打开 文件 和 保存 
文件 面板 的 操作 。 


如 果 你 想 要 将 App 提 交 到 App-Store 中 审核 ， 那 么 请 确保 在 审核 备注 中 包含 所 使 用 权限 的 说 明文 件 一 一 常见 的 ， 不 常见 的 ， 
或 者 例外 的 。 比 如 ，“MyEditor 是 一 个 文本 文档 编辑 器 ， 它 必须 有 读 取 和 写 入 user-identified (用 户 所 属 ) 文件 的 权限 ， 而 且 
需要 能 够 联网 下 载 模板 并 验证 用 户 输入 的 URL. ” 


18.4.1 为 什么 要 选择 阔 箱 


使 用 沙 箱 最 大 的 优点 就 是 你 可 以 在 应 用 商店 中 售卖 你 的 应 用 程序 ， 它 不 仅仅 是 帮 布 应 用 程序 并 获得 回报 最 方便 的 方法 。 应 用 
商店 的 访问 权限 还 能 让 你 的 App 使 用 大 量 OS X 的 特性 ， 而 这 些 特 性 都 需要 使 用 Apple 服 务 器 : 


- iCloud 
* In-app purchase 
- Push notifications 


- Game Center 


但 是 还 有 另外 一 个 原因 。 使 用 沙 箱 的 本 意 是 防止 应 用 程序 受到 外 界 的 攻击 。 即 使 App 获 得 了 一 些 权限 ， 但 它 也 不 能 抹 去 用 户 


的 文件 、 将 用 户 的 联系 方式 友和 送 给 身份 偷盗 者 ， 或 者 操作 一 个 垃圾 邮件 服务 器 (如 果 App 本 身 融 需要 一 些 必 要 的 权限 ， 它 也 会 向 
用 户 请 求 后 面 这 两 类 权限 ) 。 因 为 沙 箱 的 错误 导致 产品 贿 溃 会 让 人 很 尴 炊 ， 但 是 如 果 这 种 事情 发 生 了 ， 人 们 就 会 等 待 修复 。 违 约 
扫 摘 用户 的 系统 将 会 让 你 身败名裂 。 


18.4.2 ” 沙 箱 的 缺点 


如 果 阔 箱 不 适合 应 用 程序 的 需求 ， 那 么 就 不 要 使 用 它 。 唯 一 的 损失 就 是 你 无 法 通过 应 用 商店 售卖 应 用 程序 ， 也 不 能 使 用 
Apple 提 供 的 功能 。 


使 用 阔 箱 会 影响 什么 需求 ? 一 般 来 说 ， 如 果 你 想 要 访问 属于 系统 或 者 其 他 应 用 程序 的 资源 ， 那 么 你 就 会 完 得 沙 箱 有 些 碍 事 。 
使 用 沙 箱 时 弟 见 的 限制 如 下 : 


-访问 系统 资源 或 者 访问 限制 性 文件 。 如 果 你 想 编 写 一 个 系统 配置 编辑 器 ， 那 可 能 会 遇 到 很 多 与 沙 箱 相关 的 问题 。 


制作 一 个 辅助 应 用 程序 。 通 过 可 访问 的 API 能 制作 出 你 想 要 的 UI， 但 是 如 果 你 想 要 将 访问 事件 发 送 到 另外 一 个 应 用 程 厅 
一 一 很 多 开发 者 用 于 应 用 程序 间 通 信 的 无 奈 之 举 沙 箱 就 会 阻止 你 这 么 做 。 





- 你 能 接收 或 者 反馈 Apple 事 件 GER W T AppleScript) ， 但 是 你 只 能 将 这 些 事件 发 送 到 在 临时 权限 列表 中 的 应 用 程序 。 
Open Sctipting Atchitectute 脚 本 编辑 器 无 法 在 沙 箱 中 工作 。 


-你 无 法 访问 其 他 应 用 程序 的 偏好 设置 ， 除 非 将 你 想 要 访问 的 域名 添加 到 tempotaty exception 中 。 同 样 ， 通 过 将 其 他 应 用 程序 


绑 定 到 development team ID 的 方式 ， 可 以 在 多 个 应 用 程序 间 共 享 数据 。 
` 无 法 载 入 核心 扩展 ， 惊 讶 吗 ? 


这 些 功能 都 非常 实用 ， 也 是 非常 合理 的 需求 ， 但 是 却 无 法 在 沙 箱 中 处 理 。 


18.5 Gatekeeperf#]Developer ID 


OS X 10.8 Mountain Lion 中 引入 了 Gatekeeper， 它 是 另外 一 种 确保 用 户 安全 的 方式 ， 但 没有 沙 箱 那 么 多 的 限制 。 当 
Gatekeeper 起 作用 的 时 候 ， 所 有 下 载 的 应 用 程序 (或 者 可 执行 文档 ， 比 如 脚本 ) 都 处 于 黑 名 单 中 ， 不 允许 用 户 打开 这 些 文件 。 
只 有 那些 来 自 identified (有 身份 标识 ) 开发 者 的 App 才 处 于 白 名 单 中 。 


从 Apple 那 里 获得 一 个 加 密 的 Developer ID 并 将 它 应 用 到 App 中 ， 你 就 县 有 了 身份 标识 。 使 用 DevID 签 名 的 应 用 程序 就 可 以 
执行 ， 只 会 出 现 一 次 该 应 用 程序 下 载 自 Internet 的 警告 。 


18.5.1 获取 Developer ID 


任何 支付 了 $99 的 Mac Developer Program 成 员 都 有 Developer 1D。 事 实 上 ， 一 旦 你 加 入 Mac Developer Program 
中 ，DevID 就 无 法 避免 : 当 你 在 Accounts 面 板 中 输入 开发 者 账户 的 时 候 ，DevID 证 书 就 会 自动 创建 并 安装 。 这 是 另外 一 个 
public/private 键 值 对 ， 所 以 要 么 在 创建 开发 者 账户 文档 的 时 候 保 存 这 个 键 值 对 ， 要 么 把 它 保存 在 Keychain Access 中 。 


作为 AppleMac Developer Program 付 费 成 员 ， 你 会 拥有 5 个 签名 身份 ， 请 牢记 它们 或 者 将 它们 保存 在 钥匙 链 中 。 


- Developer ID Application 是 能 让 你 的 App 通 过 Gatekeepet 检 查 的 证 书 。 不 要 尝试 在 Code Signing Identity 中 设置 任何 证 书 。 当 


你 单 击 Archives organizer ¥ 49 Exporthttp: //www.hzcourse.com/resoutce/readBook? 


path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/... 按 钮 时 ，Xcode 会 要 求 你 选择 Developer ID 证 书 。 


- Developer ID Installet 用 于 向 Gatekeepet 保 证 非 应 用 程序 的 产品 的 安全 性 ， 比 如 安装 包 和 .xip 文 档 。Xcode 不 会 直接 使 用 


DevID installet 证 书 ， 而 是 结合 productionsign 和 xip 命 令 行 工具 一 起 使 用 。 
Os Xip 的 发 音 与 chip 相 同 。 


3rd Party Mac Developer Application 听 起 来 与 Developer ID Application 证 书 类 似 ， 但 是 与 其 更 相似 的 是 iDS 中 的 iPhone 
Distribution 身 份 : 在 构建 要 上 传 到 Mac 应 用 商店 的 应 用 程序 过 程 中 ， 你 需要 在 Code Signing Idenhtity 构 建设 置 中 选择 这 个 身份 。 与 
iOS disttibution 证 书 类 似 ， 这 个 证 书 需要 与 从 Apple 中 获得 的 配置 文件 中 应 用 程序 的 ID 匹配 。 


- 3rd Party Mac Developer Installer 4 Developer ID Installer 证 书 不 同 。 与 OS 打包 的 方式 不 同 ， 你 将 会 使 用 独立 的 签名 身份 ， 为 
验证 并 提交 到 Mac 应 用 商店 的 应 用 程序 做 准备 。Developer Application 证 书 会 在 构建 时 使 用 。 当 你 在 Archives organizer? # A 
Validate 或 者 Expott 的 时 候 ， 就 会 用 到 Developet Installer 证 书 。 你 能 看 到 可 供 选 择 的 安装 证 书 ， 选 择 Xcode 提 供 的 默认 选项 即 可 ， 
除非 你 有 特别 的 需求 。 


- Mac Developer 证 书 与 上 面 这 两 个 3rd Party Mac Developer 证 书 不 同 ， 虽 然 它 们 的 名 字 都 差不多 。 这 个 概念 与 在 :OS 开发 中 使 
用 的 iPhone Developet 身 份 类 似 。 它 是 构建 时 期 的 签名 身份 ， 用 于 测试 身份 敏感 (identity-sensitive) 的 特性 ， 如 沙 箱 、Developet 


ID 以 及 访问 Apple 云 服务 。 它 也 用 于 匹配 配置 文件 ， 在 这 个 例子 中 是 development 配 置 。 


18.5.2 使 用 Developer ID 


打开 一 个 包含 Mac 应 用 程序 target 的 Xcode 项 目 ， 然 后 选择 Product 一 Archive。 知 一 切 顺 利 ，Xcode 会 显示 市 有 你 的 应 用 
程序 文档 的 Archive 整 理 器 。 单 击 Export， 就 会 出 现 包含 各 种 选项 的 界面 ， 见 图 18.2。 最 项 上 的 这 个 选项 ，Export Developer 
ID-signed Application 融 是 你 想 要 的 选择 ， 然 后 单 击 Next (按钮 ) 。 


Select a method for export: 


© Export a Developer ID-signed Application 


Save a copy of the application signed with your Developer ID. 


Save for Mac App Store Deployment 
Sign and package application for disribution in the Mac App Store. 


Export as a Mac Installer Package 
Export a signed installer package containing the application. 


Export as a Mac Application 
Export a copy of the application. 


Cancel 





图 18.2” 当 你 在 Mac archive 上 单 击 Export 的 时 候 ， 这 个 界面 就 会 出 现 ， 上 面 提供 了 创建 Developer ID-signed 应 用 程序 的 选择 


一 旦 选择 了 发 布 方法 ，Xcode 惑 会 检查 文档 包 (archive) 、 配 置 文 件 (provisioning profile) 和 钥匙 链 (keychain) 。 然 
后 弹出 一 个 菜单 选择 你 想 要 应 用 的 签名 身份 一 一 它 通 常会 选择 正确 的 那 一 个 。 


当 收 集 加 密 签名 的 时 候 ， 会 出 现 一 个 旋转 提示 符 ， 最 后 你 将 看 到 一 个 保存 文件 的 提示 框 ， 用 于 保存 完成 的 应 用 程序 。 


Xcode 为 你 提供 了 一 个 证 书 ， 使 用 这 个 证 书 为 App 签 名 ， 然 后 将 App 放 到 硬盘 上 。 保 存 一 个 未 签名 的 应 用 程序 通 弟 会 有 更 多 
问题 。 你 可 以 按照 自己 的 喜好 友 布 App， 比 如 ，.zip 文 档 、 硬 盘 镜 像 、CD-ROMs、 邮 件 附件 、 纸 市 等 ， 它 们 都 是 Mac 应 用 程序 
的 保存 形式 。 唯 一 的 区 别 就 是 当 Gatekeeper 用 户 下 载 应 用 程序 的 时 候 ，OS X 会 允许 这 个 应 用 程序 运行 。 


St ”一旦 你 开始 将 框架 或 者 帮助 工具 内 入 应 用 程序 ， 事 情 就 会 变 得 有 点 复杂 。 每 个 都 需要 独立 于 应 用 程序 的 签名 。 这 
应 该 更 简单 些 ， 也 许 当 你 阅读 本 书 的 时 候 已 经 简化 了 这 个 流程 。 在 流程 简化 之 前 ， 先 看 看 Jetrry Krinock 在 GitHub 上 面 的 解决 方案 
"E: https://github.com/jerrykrtinock/DeveloperScripts/blob/master/SSYShipProduct.plo 


18.5.3 ”限制 


Developer ID 并 非 万 能 药 。 它 无 法 保证 应 用 程序 的 安全 性 ， 也 无 法 阻止 应 用 程序 不 作恶 ， 它 仪 会 在 第 一 次 从 下 载 区 打开 应 
用 程序 的 时 候 检 测 应 用 程序 的 和 釜 名 。 如 果 在 运行 期 注入 恶意 代码 ，Os 将 无 法 检测 。 它 也 无 法 应 用 于 任何 非 下 载 的 文件 ， 或 者 不 
是 通过 普通 的 浏 昂 器 或 邮件 附件 下 载 的 文件 。 与 应 用 商店 中 的 产品 不 同 ， 无 法 证 明 有 人 审查 过 这 个 App 的 安全 性 或 质量 。 


9 注意 ”Gatekeepet 也 会 限制 下 载 的 文档 ， 如 果 这 些 文档 是 “危险 ”的 类 型 ， 比 如 脚本 或 者 可 安装 包 。Productsign 工 具 能 在 


包 上 应 用 Installer Developer ID，xip 能 打包 “危险 ”文件 文档 ， 双 击 它 们 能 安全 打开 。 详 情 见 对 应 的 man 页 面 。 








Gatekeeper 唯 一 能 保证 的 是 一 一 很 少 对 Ul 这 么 说 一 一 应 用 程序 的 开 友 者 是 经 过 “身份 认证 的 (identified) ”。 当 你 注册 
成 为 Mac Developer Program 中 的 一 员 时 ， 你 提供 了 足够 多 的 信息 ，Apple 可 以 通过 这 些 信息 找到 你 。 如 果 他 友 现 你 曾经 发 布 
过 恶意 软件 ， 他 就 会 收回 你 的 Developer ID， 因 此 你 的 应 用 程序 将 无 法 继续 运行 。 想 要 继续 发 布 恶 意 软件 ? 那 就 再 付费 $99 注 册 
另外 一 个 账号 。 如 果 你 制作 的 恶意 程序 很 赚钱 ， 那 么 这 笔 费 用 不 过 是 小 菜 一 碟 ， 但 是 对 于 大 多 数 不 法 分 子 来 说 ，$99 是 不 小 的 开 
销 。 


这 也 就 是 为 什么 如 果 不 付费 ， 束 无 法 加 入 Mac Developer Program, 


Developer 1D 和 沙 箱 是 完全 不 同 的 概念 。 如 果 你 想 让 自己 的 App 在 Mac 应 用 商店 中 出 现 ， 那 么 必须 使 用 沙 箱 ， 而 DevID 则 
是 可 选 的 。 在 应 用 商店 之 外 ， 对 两 者 没有 什么 要 求 。 DevID 仅 能 说 明 App (到 现在 为 止 ) 的 来 源 可 靠 ， 而 无 法 说 明 这 个 应 用 是 安 
全 的 或 者 是 受 保 护 的 。 你 可 能 会 考虑 让 沙 箱 作为 安全 代码 实践 的 后 盾 。 


18.6 发布 构建 


一 旦 应 用 程序 从 开 肥 过程 走 到 友 布 过 程 (任何 友 布 的 应 用 程序 都 可 以 不 插 线 运行 ) ，Xcode 仍 然 很 友好 ， 但 是 维护 代价 稍 


at 


如 果 手 边 的 友 布 配置 (distribution profile) application ID 相 匹配 ， 它 束 会 与 App 的 配置 相 匹 配 ， 配 置 文件 会 指定 需 
的 签名 证 书 。 这 很 好 。 


18.6.1 基本 的 构建 设置 


产品 构建 设置 是 配置 文件 和 签名 认证 选取 的 关键 。 


(INFOPLIST FILE) 设置 是 产品 Info.plist 父 文件 的 名 字 。 在 Project 导 航 器 中 看 到 的 父 文件 基本 是 一 个 完整 的 Info.plist。 但 
是 它 有 一 些 需要 处 理 的 构建 设置 引用 ， 还 有 一 些 遗 漏 的 键 值 。 构 建 过 程 会 填充 这 个 文件 并 将 它 作 为 Info.plist 放 在 产品 中 。 


w+ Info.plist xt K Z HOS X 和 iOS 产 品 的 核心 ， 在 第 23 章 中 可 以 学 习 更 多 属性 列表 相关 的 知识 ， 在 22.4 节 可 以 学 习 更 多 


关于 Info.plist 的 内 容 。 


在 Info.plist 中 可 以 指定 application ID (CFBundleldentifier) ， 根 据 application ID， 构 建 系 统 就 能 确定 与 之 匹配 的 配置 
文件 (provisioning profile) 。 


至 少 在 最 近 ， 它 是 这 样 做 。 现 在 ， 它 已 经 意识 到 友 布 构建 (release build) 可 能 用 于 Ad hoc 或 者 上 友 布 ， 配 置 文件 可 能 与 通 
配 的 application ID 相 关 。 所 以 现在 构建 设置 包含 一 个 键 值 PROVISIONING PROFILE， 利 用 这 个 值 能 设置 具体 的 身份 。 弹 出 列 
表 中 包含 Xcode 所 知道 的 每 个 配置 。 现 在 它 是 可 选 的 ， 但 是 Apple 警 各 这 选项 马上 惑 要 变 为 必 选 。 


配置 文件 项 道 它 需 要 什么 签名 身份 。 如 果 你 将 签名 身份 (signing identity) 这 个 构建 设置 (CODE SING IDENTITY) 设置 
为 通用 的 iPhone Developer 或 者 iPhone Distribution 身 份 ， 那 么 构建 系统 将 会 选择 正确 的 那 一 个 。 你 也 可 以 选择 一 个 不 同 的 身 
份 ， 但 是 如 果 Xcode 发 现 它 与 你 的 App 不 匹配 ， 那 么 它 可 能 就 不 正确 。 


局 注意 在 第 25 章 中 ， 我 们 将 会 根据 目的 和 目标 平台 区 分 构建 设置 。 现 在 ， 注 意 项 目 模板 将 iOS 设 备 的 配置 文件 和 身份 信 
息 都 放 在 了 设备 专属 的 位 置 ， 这 是 因为 如 果 你 正在 执行 的 是 Debug 构 建 ， 那 么 你 可 能 像 想 让 它 运 行 在 你 的 iPhone ( 它 需 要 iOS 开 发 
者 签名 ) 或 者 1OS Simulator 应 用 程序 (不 需要 任何 签名 ) 。 不 要 更 改 设置 的 范围 ， 除 非 你 知道 为 什么 要 这 么 做 。 


如 果 一 切 准 备 得 当 ， 融 可 以 开始 做 Archive 构 建 ， 除 非 出现 特 殊 情 况 。 
18.6.2 ”调整 构建 设置 


可 能 不 会 这 么 简单 ， 在 我 的 工作 中 ， 我 们 基于 相同 的 产品 ， 使 用 3 种 不 同 的 友 布 方法 : 


. 在 将 产品 发 布 到 应 用 商店 之 前 ， 你 会 看 到 一 篇 直截了当 的 文章 。 它 需要 开发 配置 (development profiles) ， 还 有 最 终 的 应 
用 商店 发 布 配置 (distribution profile) 。 当 我 们 通过 TestFight 测 试 的 时 候 ， 我 们 使 用 相同 的 target， 唯 一 的 区 别 在 于 beta 会 注册 在 


iTunes Connect % Prerelease it n F F o 


- Ad hoc 发 布 的 beta 版 本 处 于 在 开发 者 网 站 上 注册 的 设备 中 ， 可 能 是 当前 在 应 用 商店 中 的 产品 ， 也 许 是 下 一 代 产 品 。 它 需要 
Ad hoc 发 布 配置 。 


- In-house 版 本 ， 也 就 是 使 用 Enterprise license 发 布 的 版 本 ， 它 必须 拥有 自己 的 application ID ， 因 为 它 必 须 在 Entetptise 账 户 之 
外 执行 配置 操作 ，Apple 不 允许 我 们 重复 使 用 应 用 商店 版 本 的 ID。 它 需要 自己 的 发 布 配置 ， 通 过 开发 者 计划 处 理 。 


首先 ， 让 我 们 首先 杭 理 下 Enterprise 和 应 用 商店 之 间 的 关系 : 两 个 开发 者 计划 关系 (developer-program membership) 
意味 着 两 个 不 同 的 团队 ， 每 个 团队 都 有 它 目 己 的 发布 签名 证 书 (distribution signing certificate) 和 它 目 己 的 配置 文件 
(provisioning profiles) 。Xcode 和 集成 了 配置 过 程 ， 将 每 个 target 都 与 单个 团队 关系 (team membership) 结合 在 一 起 。 我 
们 的 产品 必须 有 两 个 target : 一 个 用 于 应 用 商店 相关 的 构建 ， 还 有 一 个 用 于 Enterprise 的 构建 。 两 种 产品 每 种 都 独立 友 布 ， 我 们 
并 不 需要 马上 担心 这 所 。 


E 当然，Projects 会 有 很 多 targets， 每 个 都 有 它 自己 的 团队 关系 。 将 应 用 商店 和 Enterptise target 放 在 相同 的 项 目 中 不 会 
有 什么 问题 。 


让 我 们 继续 处 理 另 外 两 个 产品 : 面向 应 用 商店 的 产品 和 它 的 beta 版 本 。 


我 们 不 需要 将 beta 版 本 视 为 单独 的 产品 。 它 能 与 release 产 品 共 享 它 的 application 1D、 图 标 和 版 本 进度 。 如 果 是 这 样 ， 它 
们 可 以 共享 同一 个 Info.plist。 这 很 简单 ， 你 要 做 的 就 是 从 Release 配 置 中 复制 一 个 beta 构 建 配置 ， 这 个 Release 配 置 会 选择 Ad 
hoc (beta) 配置 文件 。 


9 注意 ”第 25 章 中 将 会 详细 介绍 构建 配置 的 内 容 ， 不 过 现在 我 们 可 以 简单 了 解 下 : 构建 一 款 应 用 程序 的 过 程 中 需要 调用 很 
多 独立 的 工具 ， 每 个 工具 都 需要 使 用 很 多 选项 控制 它们 的 行为 ， 并 识别 它们 的 输入 和 输出 。 构 建 配 置 就 是 这 些 设置 的 集合 。 你 可 
以 有 多 个 配置 一 一 默认 情况 下 有 Debug 和 Release 配 置 一 一 完成 不 同 的 构建 过 程 。 


这 样 一 来 ， 生 成 beta 产 品 丈 非 常 镜 单 ， 选 取 一 个 对 应 的 配置 即 可 。 如 果 你 复制 应 用 商店 target 的 scheme 并 将 它 命 名 为 
MyApp beta， 然 后 为 Archive 操 作 选 择 beta 配 置 ， 那 么 你 就 能 通过 在 工具 栏 的 弹出 菜单 中 选择 scheme 在 这 两 种 方式 之 间 切 
换 。 


在 正式 的 开发 中 ，Apple 不 建议 这 样 做 。 如 果 你 的 产品 已 经 在 App Store 中 ， 那 么 beta 版 的 产品 将 是 下 一 个 发 布 版 的 前 一 个 
版 本 。 如 果 beta 版 本 和 released 版 本 共享 相同 的 application IDs， 那 么 beta 版 本 将 会 在 测试 者 的 设备 上 履 兰 正式 此 布 版 本 的 
App。 有 些 人 想 要 提前 体验 beta 版 本 的 软件 ， 但 是 如 果 使 用 相同 的 application ID， 那 么 这 些 人 将 会 丢失 正式 版 本 的 App， 所 以 
将 会 导致 不 会 有 多 少 志愿 者 愿意 提前 体验 了 。 所 以 CFBundleldentifier， 也 就 是 App 1D 应 该 不 同 。 


CFBundleVersion (Apple 将 其 称 为 build number) 也 可 能 不 同 。 对 于 MyApp 1.1 来 说 ， 可 能 有 很 多 个 beta 版 本 ， 它 们 都 
有 相同 的 marketing CFBundleShortVersionString (1.1) 。 如 果 CFBundleVersion 也 是 1.1， 那 么 你 会 友 现 iOS (和 OS X 安 装 
器 ) 不 会 使 用 新 版 本 beta 的 App 替 换 老 版 本 的 beta App，OS 拒 绝 安装 带 有 相同 CFBundleVersion 的 包 作为 替代 品 。 举 个 build 
number 的 例子 ， 选 中 Xcode 一 About Xcode， 查 看 marketing 版 本 号 (6.1) 和 “构建 ”版 本 号 (6A1052c) 的 区 别 。 


如 果 身 份 标识 和 包 版 本 必须 要 不 同 ， 那 么 beta 版 本 的 应 用 程序 和 最 后 的 产品 必须 都 有 各 目的 Info.plist， 这 个 文件 用 于 设置 
应 用 程序 包 中 的 属性 (还 有 其 他 方面 的 内 容 ) 。 你 的 项 目 没 有 包含 一 个 实体 Info.plist 文 件 ， 相 反 ， 它 包含 了 一 个 Info.plist 的 父 
文件 ， 这 个 文件 将 会 转化 为 Info.plist 文 件 安装 到 应 用 程序 包 中 。 


在 Project 导 航 器 中 选中 产品 的 父 文 件 ， 然 后 选择 File 一 Duplicatehttp://www.hzcourse.ComyV/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (8S) 。 为 新 文件 指定 一 个 能 反映 target 名 称 
及 作为 beta 版 本 用 途 的 合适 名 称 。 修 改 新 文件 : 


` 为 这 个 文件 指定 自己 的 CFBundleldentifier (bundle ID) ， 因 为 你 不 想 履 盖 测 试 者 设备 上 面 正式 版 本 的 应 用 程序 。 你 需要 在 
网 站 上 注册 这 个 ID， 同 时 (对 于 beta 版 本 的 产品 来 说 ) 让 Apple 为 这 个 ID 提供 一 个 Ad hoc 配 置 文件 。 


- 为 beta 自 己 的 图 标 文 件 创 建 名 称 ， 这 样 测试 人 员 就 能 分 辨 出 beta 版 本 的 产品 和 最 终 的 产品 。 你 需要 手动 添加 图 标 键 值 : 构 
建 系统 会 根据 tafget 编 辑 器 中 的 设置 创建 图 标记 录 ， 但 是 对 于 自 定义 的 blist 来 说 ， 你 应 该 自己 完成 这 个 步骤 。 第 22 章 中 能 找到 相应 
的 键 值 及 其 含义 。 


- 设置 CFBundleVersion 确 认 你 选择 的 构建 版 本 scheme。 


- 你 可 能 想 让 beta 版 本 有 一 个 特别 的 名 称 ， 但 是 没有 设置 Bundle name (CFBundleName) 。 默 认 情 况 下 ， 它 会 设置 为 
${PRODUCT_NAME} 的 值 ， 这 个 值 来 自 于 当前 配置 中 的 Build Settings. 


创建 这 样 一 个 配置 : 复制 Project 编 辑 器 中 的 Release 配 置 ， 创 建 一 个 Ad hoc 构 建 配置 ， 它 会 在 Target 编 辑 器 的 Build 
Settings 选 项 卡 的 全 部 配置 中 添加 一 个 Ad Hoc 变 量 。 通 过 单 击 设置 行 调整 Ad Hoc 变 量 的 设置 ， 单 击 提示 三 角 显 示 出 Ad Hoche 
置 : 选中 复制 出 来 的 Info.plist 父 文件 ， 将 Product Name 设 置 为 能 区 分 出 beta 版 本 的 名 称 ， 同 时 选中 Ad hoc 配 置 文件 。 

然后 为 构建 beta 版 本 创建 一 个 新 的 scheme: 使 用 Product 一 Scheme 一 Manage 
Schemeshttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 显 示 出 项 目的 构建 schemes 列 表 。 为 你 的 产品 复 
制 一 个 默认 的 scheme， 为 它 提 供 一 个 名 称 (My App Ad Hoc) 并 单 击 Edithttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/AText/.……。 对 于 Archive 操 作 ， 为 目 定 义 的 Ad ho 配置 设 

置 Build Configuration。 项 目 窗 口 工具 栏 中 的 弹出 菜单 中 会 显示 这 些 scheme。 你 可 以 在 beta 和 final release 中 实时 切换 。 


最 后 ， 新 版 本 已 经 足够 好 ， 可 以 用 它 来 蔡 换 旧版 本 。 此 时 ， 就 可 以 继续 执行 ， 发 布 TestFlight publibc beta， 使 用 你 为 应 用 
丙 店 发 布 版 设置 的 scheme。 


18.6.3 ”构建 


目标 就 是 生成 一 个 可 以 用 来 生成 可 发 布 产品 的 archive。 为 了 生成 一 个 archive 你 必须 要 有 : 
- 所 需 的 发 布 ( 在 OS X 中 是 安装 ) 标识 ， 包 含 钥匙 链 中 的 公 钥 和 私 钥 。 
“ 发 布 产品 所 需 的 用 于 授权 的 配置 文件 。 
: 选择 合适 配置 文件 的 构建 设置 ， 以 及 声明 了 相 匹 配 bundle ID 的 Info.plist。 
- 在 Archive 操 作 中 指定 正确 构建 配置 的 scheme。 
- 在 项 目 窗口 工具 栏 最 左边 的 弹出 菜单 中 选择 scheme 和 一 个 目标 设备 (不 是 模拟 器 ) © 
选中 Product 一 Archive， 等 待 ， 假 设 没有 构建 错误 ， 那 么 Archives organizer 中 融会 显示 出 你 的 产品 。 


EE 这 是 另外 一 个 “如 果 一 切 顺利 ”的 情形 。 如 果 出 现 常 规 的 编译 、 链 接 或 者 资源 错误 ， 你 会 知道 怎么 解决 。 但 如 果 


出 现 的 是 配置 (ptovisioning) 问题 





涉及 配置 (profile) ， 身 份 标 识 (identifier) 和 证 书 (certificates) 一 一 每 个 构建 的 具体 情 
况 都 不 相同 。 在 Documentation 浏 览 器 中 ， 查找 App Distribution Guide 中 Troubleshooting 这 一 草 ， 然 后 从 这 里 开始 查找 解决 方法 。 


如 果 你 的 目标 是 将 产品 提交 到 应 用 商店 中 ， 那 么 你 需要 使 用 Tunes Connect 注 册 这 个 App， 提 供 所 有 的 市 场 、 法 规 和 技术 
信息 ， 包 括 application1D。 你 必须 要 告诉 TC 这 个 应 用 程序 处 于 “准备 好 上 传 ”的 状态 ( 接 下 来 残 轮 到 你 准备 好 应 用 程序 ) 。 


当 这 一 切 都 准备 完毕 的 时 候 ， 就 可 以 单 击 Validatehttp://www.hzcourse.comy/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 按 钮 让 你 的 App 完 成 一 些 自动 测试 。 然 后 单 击 


Submithttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...， 让 Xcode 将 二 进 制 文件 包 提 交 到 应 用 两 店 中 。 


这 样 束 让 你 的 App 进 入 了 审核 阶段 ， 我 们 希望 能 顺利 友 布 。 


18.7 ”小结 


用 于 开发 和 发 布 的 配置 工作 向 来 都 很 复杂 ， 但 是 在 过 去 的 这 些 年 中 ， 这 个 过 程 已 经 简单 了 很 多 。Xcode 和 Apple Developer 
Program 已 经 尽力 让 更 多 的 开 上 友 者 在 这 个 过 程 中 感到 舒适 。 


但 你 还 是 要 了 解 最 基本 的 原则 一 一 什么 是 配置 系统 想 要 的 ， 以 及 Xcode 如 何 包 装 了 这 个 过 程 一 一 以 防 你 有 一 些 自 定义 的 需 
求 或 者 恰恰 配置 过 程 出 了 问题 。 我 回顾 了 将 App 安 装 到 iOS 设 备 中 所 需 的 3 个 最 基本 的 要 素 : 签名 (signature) 、application 
ID 以 及 授权 的 设备 。 其 他 的 内 容 都 是 常见 的 theme 变 量 。 


记 住 这 些 内 容 ， 那 些 原 本 很 神奇 的 内 容 对 你 来 说 也 变 得 十 分 清晰 。 你 看 到 了 身份 标识 (identity) 、 权 限 (entitlement) 
和 许可 (permission) 之 间 的 相互 影响 都 聚集 在 了 一 起 ， 生 成 要 友 布 的 应 用 程序 ， 无 论 是 通过 应 用 商店 还 是 (在 OS X 应 用 程序 
的 情况 下 ) 通过 你 目 己 的 方法 友 布 ， 这 些 内 容 全 少 能 告诉 你 的 用 户 这 个 应 用 程序 没有 害处 。 


第 三 部 分 Mac OSX 开 友 中 的 Xcode 


第 19 章 ”开始 制作 OS X 应 用 程序 
| 第 20 章 ” 绑 定 : 连接 OS X 应 用 程序 
` 第 21 章 ”本 地 化 
. 第 22 章 ”程序 包 


` 第 23 章 ”属性 列表 


第 19 草 ”开始 制作 OS X 应 用 程序 


现在 你 已 经 拥有 了 进行 OS X 开 发 的 技术 。 如 果 你 是 一 名 Mac 开 发 者 ， 我 希望 你 不 要 跳 过 第 二 部 分 。 该 部 分 介绍 的 大 部 分 内 
容 同样 适用 于 Mac 项 目 ， 所 以 本 章 不 乾 述 。 


同样 ， 如 果 你 的 兴趣 点 在 iOS 开 友 ， 那 么 也 不 要 停止 阅读 ， 因 为 还 没有 讲 完 ! 虽然 Bundles 和 属性 列表 并 不 是 OS X 中 需要 优 
先 考 虑 的 事 ， 但 是 你 需要 知道 这 些 内 容 在 Cocoa 开 发 中 的 地 位 。 尤 其 是 ， 需 要 注意 第 22 章 中 天 于 Info.plist 这 一 部 分 的 内 容 。 


现在 我 们 要 做 的 就 是 将 Passer Rating 这 个 iPhone app 移 植 到 OS X 上 。 因 为 采用 了 Model-View-Controller (模型 -视图 - 
控制 器 ) 的 设计 模式 ， 所 以 应 用 程序 模型 这 一 层 基 本 没有 更 改 (里 然 可 能 需要 稍微 扩展 一 下 ) 。 视 图 和 控制 器 层 都 是 全 新 的 ， 两 
个 平台 (iOS 中 的 UIKit 和 Mac 中 的 AppKit) 的 用 户 界面 层 虽 然 共 用 一 些 概念 ， 但 是 意义 却 不 相同 。 


Oza 本 章 建立 在 iOS Passer Rating 应 用 程序 的 基础 之 上 。 介 绍 集中 在 构建 OS X 应 用 程序 的 工作 流 上 ， 代 价 就 是 对 适 配 所 
需 的 内 容 完全 透明 。 在 你 使 用 Xcode 实 例 化 项 目 模板 之 后 ， 你 必须 下 载 示 例 代 码 (如 果 你 还 没 下 载 的 话 ) ， 否 则 你 将 无 法 跟 上 本 
书 的 步伐 。 我 也 很 难 做 出 权衡 ， 可 供 替 代 的 选择 就 是 通过 代码 之 间 的 差异 体现 Xcode 技 术 〈 本 书 的 主题 ) 。 我 将 会 引领 你 体会 这 
个 过 程 ， 但 是 拥有 本 章 用 到 的 代码 将 会 很 方便 ， 这 样 就 能 弥补 不 足 。 


19.1 目标 


提 面 应 用 程序 与 移动 App 之 国有 大 量 的 差别 。 提 面 应 用 程序 将 大 部 分 信息 显示 在 窗口 中 ， 用 户 希 刻 用 文档 的 方式 显示 数据 处 
理 窗 口 ， 每 个 窗口 都 将 文件 存储 在 各 自 的 文件 中 。Mac 版 本 的 Passer Rating 只 能 通过 一 个 数据 集 显 示 一 个 窗口 ， 但 是 正如 你 所 
见 ， 文 档 操作 并 不 困难 。 那 样 ， 用 户 可 以 将 passer 统 计数 据 组 成 联盟 数据 ， 联 盟 数 据 可 以 和 其 他 数据 交换 。 


iOS 版 本 Passer Rating app 的 顶层 是 一 个 passer 列 表 。 如 果 有 多 个 文档 可 行 呢 ? 如 果 你 有 各 个 联盟 数据 的 文 要 ， 那 么 将 
team 作 为 数据 集 的 根 忆 点 会 更 好 。 这 需要 简单 修改 数据 模型 ， 马 上 我 们 殊 会 完成 这 个 修改 。 


所 以 一 个 联盟 (文档) 有 一 个 team 列 表 。 每 个 team 都 有 一 个 (至少 一 段 时 间 内 ) 为 这 个 team 效 力 的 passer 列 表 ， 每 个 
passer 又 有 一 个 比赛 成 绩 的 列表 。 当 处 理 ijPhone 界 面 的 时 候 ， 同 一 时 刻 只 显示 层次 结构 中 的 一 层 。 在 梨 面 系统 上 ， 你 可 以 让 所 
有 的 层级 都 显示 出 来 。 我 们 的 目标 应 该 如 图 19.1 所 示 。 


@ Š Untitled — Edited 


Augusta Autocrats 
Boise Bearcats Passers for the Boise Bearcats 
Dos Moines Desporadoes Name Rating 


Fremont Firebugs William Harrison 

Gondal Centers Warren Harding 97.8 486 
Grand Rapids Gamers Frank Pierce 30.8 1,364 
Huntington Beach Harriers Abe Lincoln 149.3 1,377 


Mobile Misfits Cal Coolidge 2995 1.890 
Modesto Misanthropes 
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图 19.1 图 中 就 是 我 们 想 要 的 Mac 版 本 的 Passef Rating 的 效果 ， 至 少 在 这 个 例子 中 ， 我 们 要 完成 这 个 目标 。 用 一 个 文档 展示 由 多 个 
team (左边 的 表 ) 组 成 的 league 人 信息。 选中 一 个 team， 就 会 在 上 面 的 表 中 显示 出 为 这 个 team 效 力 的 passef 信 息 列 表 。 选 中 一 个 
passet， 就 会 在 下 面 的 表 中 显示 这 个 passetr 所 有 的 比赛 数据 。 单 击 其 中 一 个 game 数 据 ， 就 会 弹出 一 个 窗口 ， 显 示 这 场 比赛 的 详细 信 


自 


nS 


19.2 开始 


建立 一 个 Cocoa 应 用 程序 项 目 与 第 2 草 中 介绍 的 没有 什么 不 同 : 选中 File 一 New 一 New Project, MRA- LFA 
间 窗 口 和 一 个 New Project 帮 助 界面 。 在 左边 的 主 列表 中 选中 OS X 一 Application， 然 后 在 右边 选中 Cocoa Application 图 标 ， 
单 击 Next 按 钮 。 


现在 来 到 了 项 目 选 项 面板 ， 这 里 有 不 少 选 


- Product Name 这 一 栏 中 显示 的 是 Mac Passer Rating。 对 于 这 个 应 用 程序 来 说 这 个 名 称 不 太 合适 一 一 用 户 知 道 自 己 正 在 使 用 
Mac 计 站 机 ， 也 不 关心 其 他 的 版 本 一 但 是 如 果 项 目 有 一 个 独特 的 名 字 ， 会 方便 记忆 。 在 Target 编 辑 器 中 Build Setting 选 项 卡 下 的 





Product Name 栏 中 可 以 修改 产品 名 称 。 





版 权 所 有 者 





- Organization Name 
- Company Identifier#H 2% J application ID 的 前 组。 我 这 里 用 的 是 com.wt9t， 你 需要 输入 自己 的 。 


- Bundle Identifiet 由 公司 标识 (company identifier) 和 产品 名 称 (product name) 组 合 而 成 。 使 用 它 可 以 将 你 的 应 用 程序 在 系 
统 和 应 用 商店 (如果 你 想 要 让 应 用 程序 在 Mac 应 用 商店 中 发 布 ) 中 与 其 他 应 用 程序 区 分 开 。 这 个 栏 无 法 编辑 ， 仅 仅 用 于 显示 。 


- Language 的 选择 有 Objective-C 和 Swift。 为 我 们 要 与 时 俱 进 ， 所 以 选择 Swift。 
- Yosemite 和 Xcode 6 在 Mac 开 发 中 引入 了 stotyboatd ， 我 们 想 要 使 用 这 个 功能 ， 所 以 勾 选 Use Storyboards. 


因为 这 个 App 会 生成 一 些 文档 ， 所 以 匀 选 Create Document-Based Application。 这 个 面板 中 的 文档 选项 对 Xcode 模板 生成 的 项 
目 有 很 大 影响 。 


- OS X 依 赖 文 件 名 的 后 组 来 管理 文件 属于 哪个 应 用 程序 。Mac Passer Rating 并 不 会 共享 任何 常见 的 文档 类 型 ， 所 以 在 
Document Extension 中 填写 一 些 独 特 的 字符 串 ， 如 leaguedoc， 不 能 包含 点 号 。 不 要 以 为 只 能 填写 3 个 或 者 4 个 字符 : 使 用 Mac Passer 
Rating 的 用 户 不 需要 输入 这 个 扩展 名 。 


若 在 iOS 版 本 的 Passer Rating 中 你 使 用 了 Core Data， 则 在 Mac 版 本 中 也 要 使 用 Core Data, PVA 4) wUse Core Data. 


然后 单 击 Next 按 钮 ， 残 会 出 现 一 个 选择 项 目 人 存储 文件 夹 (默认 名 字 可 能 是 Mac Passer Rating) 的 界面 。 选 择 一 个 文件 夹 ， 
勾 选 Create git repository on， 如 果 有 就 选择 一 个 Xcode server， 如 果 没 有 就 选择 My Mac， 然 后 单 击 Create 按 钮 。 现 在 ， 工 
作 空 间 中 束 是 这 个 应 用 程序 的 锥 形 。 


Document.swift 中 定义 了 载 入 和 存储 联盟 数据 的 类 ， 并 用 这 个 类 展示 和 编辑 这 些 数据 。Document 是 Model-View-Conttollet 模 
式 中 的 控制 器 类 。AppKit，Mac 应 用 程序 的 Cocoa 框 架 ， 包 含 了 管理 文档 的 复杂 scheme， 它 的 核心 是 NSDocument 类 。 


NSDocuments 会 对 数据 的 读 取 、 保 存 、 展 示 或 者 编辑 做 出 响应 。 你 的 文档 子 类 几乎 不 用 自 定义 这 些 标准 行为 。 


- 因为 你 让 文档 使 用 了 Core Data，Document 是 NSPersistentDocuemnt 的 子 类 ， 这 个 类 为 你 完成 了 很 多 工作 ， 它 能 处 理 载 入 和 
保存 数据 ， 处 理 重 做 和 撤销 事件 。 


` 现在 让 我 们 重 命 名 类 和 和 文件， 显示 它们 在 应 用 程序 中 的 角色 : 执行 全 局 替换 操作 ， 将 Document 更 改 为 LeagueDocument; 
WindowController 替 换 为 LeagoueWindow Controller; ViewController 更 改 为 LeageueViewController。 记 得 ， 要 将 Find 弹 出 窗口 最 后 一 段 
更 改 为 Matching， 这 样 才 能 精确 地 匹配 并 更 新 文件 名 。 


- Document.xcdatamodeld 是 为 原始 的 Document 类 准备 的 空 数据 模型 。 我 们 将 会 删除 它 ， 为 我 们 已 经 有 了 一 个 几 近 完整 的 


Passer Rating 模 型 。 


加 敬告 还 没有 完成 所 有 的 替换 工作 。Find 导 航 器 可 以 保证 更 改 stotyboatd 中 的 类 名 ， 但 是 你 不 得 不 选中 那些 对 象 ， 然 后 在 
Identity inspector 中 更 改 它们 的 名 称 。 


可 能 你 还 想 更 改 窗口 控制 器 (window-controller) 场景 的 名 称 (ldentity inspector, Storyboard ID “League Window 


Controller” ) 。 


Images.xcsasets 是 应 用 程序 中 要 使 用 的 图 标 和 图 片 的 集合 。 图 片 集合 减轻 了 现今 应 用 程序 中 为 了 适应 多 分 辨 率 和 屏幕 尺寸 
而 需要 准备 各 种 图 片 的 负担 ， 在 第 13 章 中 有 详细 介绍 


- Supporting Files 组 中 的 Info.plist 是 Info.plist 的 父 文件 ， 它 描述 了 应 用 程序 在 Finder 和 Launch Services 中 的 属性 和 行为 。Tarpet 
editot 中 的 General 和 Info 选 项 卡 提 供 了 一 个 (相对 ) 简单 的 方法 自 定 义 这 个 文件 。 记 住 ， 第 22 草 和 第 23 章 会 详细 介绍 Info.plist。 


InfoPlist.strings 提 供 了 与 Info.plist 中 条 目 相 匹配 翻译 版 本 。 


` 之 前 这 是 一 个 Objective-C 项 目 ，Suppotting Files 将 会 包含 Mac Passer Ratine-Prefix.pch， 它 是 项 目 预 编译 头 文件 的 源 文件 。 可 


以 回顾 第 5 章 中 的 内 容 。 
- Main.storyboard 将 会 编译 为 应 用 程序 的 用 户 界 面 。 


- AppDelegate.swift 定 义 了 AppDelegate， 它 是 应 用 程序 委托 类 。 基 本 不 需要 你 继承 AppKit 的 基础 应 用 程序 类 NSApplication， 
每 个 自 定义 的 基本 都 可 以 通过 这 个 委托 实现 。Mac Passer Rating 其 至 连 这 个 委托 都 不 需要 ， 我 们 不 涉及 这 个 文件 。 


与 iOS 模 板 一 样 ，Mac Passer Rating 现 在 可 以 运行 。 选 择 Product 一 Run (ÆR) ， 过 一 会 ， 应 用 程序 就 会 运行 起 来 。 但 是 
你 不 会 看 到 太 多 内 容 ， 只 有 一 个 菜单 栏 ， 其 中 有 一 个 Mac Passer Rating 选 项 。 选 择 
File>New—Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (¢6N) ， 然 后 你 就 能 看 到 一 个 文档 窗口 ， 它 可 
以 关闭 、 调 整 大 小 ， 甚 至 可 以 保存 为 一 个 文件 。 然 后 在 Finder 中 双击 打开 ， 见 图 19.2。 



































@ Mac Passer Rating Mg Edit Format View Window Help 
EN 
HO EE— 
Open Recent p untitled 


Close de W 
Save... HS 
Duplicate 

Rename... 

Move To... 


Revert To | 
ent contents here 


Page Setup... Q#P 
Print... WP 


Mac Passer Rating 
Version 1.0 (1) 
Copyright © 2014 Fritz Anderson. All rights reserved. 





图 19.2 ”文档 应 用 程序 模板 运行 起 来 以 后 如 图 所 示 。 它 能 创建 新 文档 并 保存 在 一 个 文件 中 ， 之 后 可 以 在 Findet 中 重新 打开 。 我 有 
些 心急 ， 在 Imags.xcassets 中 添加 了 一 个 ApplIcon 集 ， 标 准 的 About 对 话 框 中 会 使 用 其 中 的 图 片 


Osa 如 果 此 时 你 保存 了 一 个 文档 ， 请 确保 删除 它 。 因 为 你 会 更 改 Mac Passer Rating 中 的 数据 模型 。 之 前 ，Cote Data 会 莫 
名 其 妙 的 前 渍 并 让 你 猜测 原因 ， 但 是 现在 它 会 抛 出 一 个 异常 并 且 带 有 相应 的 描述 : The autosaved document: could not be 
reopened. The managed object modelversion used to open the persistent store is incompatible with the one that was used to create the 


persistent stote. 请 查看 调试 控制 器 。 


xs NSPersistentDocument 支 持 处 理 OS 又 文档 的 所 有 标准 行为 : 创建 、 读 取 、 编 辑 和 保存 。 你 仅 需 在 应 用 程序 中 添加 


相应 的 说 明 。 但 是 : 如 果 你 选择 File 一 Duplicatehttp://www.hzcourse.com/resource/readBook? 
path= /opentesources/teach_ebook/uncompressed/15555/OEBPS/Text/..., tds ， 然 后 保存 一 个 新 文件 ，AppKit 就 会 按照 文档 文件 
处 理 ， 在 文件 名 后 面 加 上 -wal 和 -shm。 如 果 没 有 这 两 个 后 经， 文档 文件 会 被 认为 损坏 而 无 法 读 取 。 两 个 主要 的 OS 又 版 本 都 会 出 现 


这 个 问题 。 当 我 撰写 本 章 时 ， 最 佳 的 解决 方法 是 使 用 Mike Abdullah 提 供 的 BSManagedDocument 类 。 


一 旦 新 鲜 感 消 失 ， 可 能 你 会 将 这 个 应 用 程序 改 成 与 足球 相关 的 应 用 程序 。 


19.3 ”模型 
正如 我 所 品 ， 在 层级 中 再 添加 一 层 一 一 team 一 一 需要 对 模型 做 一 些 更 改 。 我 们 可 以 从 iOS Passer Rating app 的 数据 模型 
和 支持 类 开始 做 相应 的 更 改 。 


现在 我 们 可 以 删除 Document.xcdatamodeld， 使 用 已 经 存在 的 那个 。 在 Project 导 航 器 中 选中 它 ， 然 后 按 delete 键 ; 当 
Xcode 询问 你 要 执行 什么 操作 的 时 候 ， 单 击 Delete 按 钮 。 模 型 文件 的 名 称 无 关 紧 要 ， 所 以 更 改 为 其 他 名 字 也 没关系 。 默 认 的 
NSPersistentDocument 会 载 入 所 有 编译 过 的 .mom 文 件 ， 然 后 将 它们 合并 到 一 个 单独 的 模型 中 。 


19.3.1 ”从 iOS 移 植 


选中 File 一 Add Files to “Mac Passer Rating” http://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (CHA) 就 会 出 现 一 个 选择 文件 的 界面 (R 
在 Project 导 航 器 可 见 的 时 候 ， 这 个 命令 才 有 效 ) 。 进 入 包含 iDOs Passer Rating app 源 文件 的 目录 ， 选 中 所 有 的 文件 (FRE 
command 键 可 以 一 次 选中 多 个 文件 ) 。 


- SimpleCSVFile.swift 

` rating. swift 

- mogenerated 目录 或 者 任何 包含 Game 和 Passet 类 的 目录 

- Passer Rating.xcdatamodel (Data-model X#F EOS X 和 iOS 项 目 之 间 通 用 ) 
- Extensions.swift 

- Utilities.swift 


添加 这 些 文件 后 ， 需 要 针对 OS X 系 统 进 行 调整 ， 有 一 些 要 import UIKit，Extensions.swift 应 该 丢失 UITableView 和 
NSFetchedResultsController 的 扩展 。 


注意 ”如果 你 没有 跟着 本 书 介绍 的 iOS 部 分 一 起 学 习 ， 那 么 你 可 以 从 示例 代码 中 找到 这 些 文件 。 如 果 你 重新 组 织 了 iOS 源 
目录 ， 将 文件 存 于 不 同 的 子 目录 中 ， 那 么 你 需要 分 别 添加 每 个 文件 夹 中 的 文件 。 


Z)izCopy items into destination group’ s folder (if needed) ; 选择 Create groups for any added folders， 这 样 
mogenerated 类 文件 会 被 单独 添加 ， 而 不 是 在 构建 的 时 候 添加 ; 确保 勾 选 Add to Targets 表 中 的 Mac Passer Rating 选 项 。 单 
击 Add 按 钮 ， 这 些 文件 束 会 出 现在 Project 导 航 嚣 中。 你 可 能 想 要 选中 全 部 这 些 文件 ， 使 用 File 一 New 一 Group from 
Selection， 然 后 将 这 个 新 组 重 命 名 ， 比 如 Model。 


全 注意 现在 最 好 将 项 目 提交 到 本 地 代码 库 中 。 


1 9.3.2 添加 实体 


下 一 步 束 是 将 ourTeam 从 Game 中 分 离 (精通 数据 库 的 开 友 者 会 这 规 泄 化 ) ， 形 成 一 个 新 实体 : Team。 单 击 Passer 
Rating.xcdatamodel， 然 后 (使 用 第 9 章 中 学 到 的 技术 ) 创建 一 个 Team 实 体 ， 这 个 实体 带 有 一 个 属性 teamName， 它 应 该 是 
ee 索引 、 必 选 ， 它 有 一 个 明显 错误 的 默认 名 称 ， 如 NASSIGNED NAME。 添 加 一 个 关系 games， 与 多 个 Game 实 体 相 

删除 应 该 是 级 联 的 。 


Game 会 失去 ourTeam 属 性 ， 得 到 team 属 性 ， 它 与 Team 是 一 对 一 的 关系 ， 删 除 时 对 应 的 操作 为 nullify。 确 保 在 Team 对 应 
的 game 上 也 建立 同样 的 关系 。 当 你 完成 这 一 切 的 时 候 ， 数 据 模型 看 起 来 应 该 如 图 19.3 所 示 。 


Attributes 
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current Team lourScore 
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图 19.3 ”对 于 Mac 来 说 ，Passet Rating model 添 加 了 一 个 Team 实 体 。 每 个 Team 都 与 多 个 Games 相 关联 。Game 的 ownTeam 字 段 属性 没 


有 了 ， 取 而 代 之 的 是 team.teamName 
有 了 Passer 和 和 Game 之 后 ， 你 可 能 想 要 添加 生成 Team 的 便捷 方法 ， 这 需要 一 个 NSManagedObject 子 类 包 闭 Team 实 体 。 


你 可 能 仍然 需要 创建 Team 类 ， 而 且 需 要 根据 修改 后 的 模型 更 新 已 经 存在 的 机 器 生成 类 。 在 Data Model 编 辑 器 中 选中 Team 
实体 ， 显 示 出 Core Data 查 看 器 (Utility 区 中 的 第 三 个 选项 卡 ) ， 然 后 将 Class 设 置 为 Team。 


现在 打开 Terminal， 重 新 生成 类 文件 。 


$ # cd to the same directory that includes Passer_Rating.xcdatamodeld. 
$ cd 'whatever/Mac Passer Rating' 
$ # Run mogenerator. 
$ mogenerator --model Passer_Rating.xcdatamodeld \ 
--output-dir mogenerated \ 
- -swift 


3 machine files and 1 human files generated. 


$ 


Ou mogeneratot 将 会 保留 用 户 可 编辑 的 Game.swift 和 Passer.swift 文 件 ， 所 以 在 新 项 目 中 运行 mogeneratot 也 不 会 有 危险 。 


如 果 没 有 保存 旧 代 码 ， 那 么 1 


Passet.Swift 和 Game.swift 文 件 。 


尔 可 以 在 本 章 结 尾 的 示例 代码 中 找到 相应 的 代码 。 有 一 点 要 注意 


第 三 部 分 将 会 依赖 第 


这 个 项 目 不 包 含 任何 扩展 ， 所 以 没有 app-gtoup 容 器 或 者 系统 级 的 存储 。 


使 用 File 一 Add Files to “Mac Passer Rating” http://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/... 
已 应 该 添加 到 Mac Passer Rating 这 个 target 中 ， 按 照 文件 组 的 形式 添加 ， 而 不 单单 只 是 已 


$17 章 之 前 的 


(YEA) 将 mogenerated 目 录 添 加 到 项 目 中 。 
已 经 存在 文件 夹 的 引用 。 


之 前 我 们 想 要 在 Team 中 添加 一 个 便捷 方法 ， 这 样 我 们 融 能 快速 找到 并 创建 Teams。 进 入 Team.swift 文 件 ， 创 建 这 个 方法 和 


一 系列 派生 属性 。 


import Foundation 
import CoreData 


@obj c (Team) 


class Team: 


_Team { 


class func teamWithName (name: String, 


-> Team? 


var retval: 


let fetch = 
fetch.predicate = NSPredicate ( 


format: 
var error: 
let result 


error: &error) 


context: NSManagedObjectContext, 


create: Bool) 


Team? = nil 
NSFetchRequest (entityName: "Team") 


"teamName = %@", name) 
NSError? = nil 


context.executeFetchRequest (fetch, 


if let records = result { 


if records.count > 0 { 


retval = 


} 


(records [0] as! Team) 


else if create { 


retval = 
retval?.teamName = name 


} 


else { 


NSLog ("\ (__ 


} 


return retval 


Team (manadedobJjectContext : context) 


FUNCTION ): Could not execute a fetch of \(name)") 


var ownTotalScore: Int { 
return self.games.valueForKeyPath("@sum.ourScore") as! Int 


var oppTotalScore: Int { 
return self.games.valueForKeyPath("@sum.theirScore") as! Int 


} 


var passers: 


[Passer] { 


let unionOfPassers = 
self.games.valueForKeyPath ("@distinctUnionOfObjects.passer") 


as! 


NSSet? 


if let passerSet = unionOfPassers { 
return passerSet.allObjects as [Passer] 
} 
else { 
return [] 


因为 数据 模型 已 经 更 改 ， 所 以 Passer 和 Game 也 应 该 做 出 相应 的 修改 。 在 csvFile:read Values:error 创 建 Game 的 地 方 ， 使 


用 teamWithName( ,context:,create: ) 链 接 到 Team 上 ， 而 不 是 直接 记录 ourTeam 字 符 串 。 


newGame.team = 
Team.teamWithName (values ["ourTeam"]!, 
context: context, create: true)! 


其 他 地 方 ， 在 Game 中 通过 ourTeam 引 用 的 team 名 称 的 地 方 ， 都 要 改 为 team.team Name。 比 如 ， 在 Passer.swift 中 : 


var teams: [ String ] 
{ 
let theGames: AnyObject = 
self.games.valueForKeyPath ( 
"@distinctUnionOfObjects.ourTeam") ! 


return theGames.allObjects as! [ String ] 
} 
更 改 为 
var teams: [ String ] { 


let theGames: AnyObject = 
self.games.valueForKeyPath ( 
"@distinctUnionOfObjects.team.teamName") ! 
return theGames.allObjects as! [ String ] 


记 住 ， 将 existingPasserByName(last:,context:) 回 退 到 在 特定 的 NSManagedObject Context 中 查找 Passers 的 版 本 ， 而 不 
是 为 整个 应 用 程序 在 内 存 中 保存 一 份 。 


class func existingPasserByName(first: String!, 
last:String!, 
context: NSManagedObjectContext! 
-> [Passer] 


同时 要 确保 existingPasserByName( ,last:,context:) 使 用 Core Data，passers 应 该 在 特定 的 上 下 文中 查找 到 ， 而 不 是 从 一 
个 全 局 字典 中 获取 。 


let fetchStrategy:PasserFetchStrategy = .StraightCoreData 


Oe 你 可 以 参考 本 章 结尾 处 的 示例 代码 查看 详细 情况 。 


19.4 制作 荣 单 


在 我 们 继续 前 进 之 前 ， 让 我 们 先 做 点 别 的 工作 。LeagueDocument 会 载 入 一 些 示 例 数据 (对 ， 融 是 之 前 在 iOS 应 用 中 使 用 
过 的 .csv 文 件 ) 并 至 少 展示 一 些 team 的 名 称 吗 ? 


首先 要 在 Mac Passer Rating 的 Edit 荣 单 中 添加 一 个 载 入 文档 的 选项 。 在 Project 导 航 器 中 选中 MainMenu.xib，lnterface 
Builder 丈 会 在 辆 布 中 显示 3 个 场景 : Application 场 景 、Window Controller 场 景 以 及 View Controller 场 景 。 我 们 感 兴趣 的 是 
Application 场 景 ， 它 由 App Delegate 和 First Responder 以 及 Main Menu 占 位 符 组 成 。 


Main Menu A EMAR ih, OS X 项 目 模板 提供 的 是 预 载 入 的 菜单 ， 它 已 经 准备 好 了 语法 检查 、 富 文本 表 等 功 
能 。 单 击 Application 场 景 中 的 Edit 标 签 展开 Edit 荣 单 。 菜 单 的 下 半 部 包含 大 量 的 条 目 ， 可 以 用 来 搜索 和 语音 功能 ， 但 是 它们 都 不 
适合 Mac Passer Rating。 逐 一 单 击 这 些 条 目 ， 按 下 delete 键 。 


做 这 个 操作 的 时 候 ， 同 时 也 删除 Format 和 View 选 项 ; 但 是 注意 : 在 按 下 delete 键 之 前 要 天 闭 菜 单 。 在 AppKit 荣 单 的 特定 层 
级 中 ， 菜 单 栏 是 一 个 菜单 ， 它 包含 很 多 菜单 选项 ， 这 些 荣 单 选项 本 身 可 能 也 是 一 个 荣 单 。 如 果 你 想 要 删除 展开 的 Format 荣 单 
(比如 ) ，Xcode 融 会 删除 这 个 荣 单 ， 但 是 并 不 会 删除 包含 这 个 莱 单 的 菜单 项 。 从 荣 单 栏 中 的 空 栏 仍然 仓 人 在 你 残 能 了 解 到 这 一 
点 。 选 中 并 删除 它 ， 或 者 关闭 这 个 菜单 ， 那 么 按 delete 键 就 会 同时 删除 这 个 菜单 及 其 包含 的 选项 。 


你 需要 在 Object library (组 件 库 ，Utility 区 下 方 的 第 三 个 选项 卡 ) 中 拖 出 一 个 菜单 选项 到 菜单 中 。 在 库 的 搜索 域 中 输入 
menu， 找 到 Menu Item， 让 后 将 它 拖 到 打开 的 Edit 荣 单 底部 ， 见 图 19.4。 
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图 19.4 将 一 个 菜单 选项 拖 动 到 菜单 中 


双击 Item 标签 ， 然 后 将 它 的 名 字 改 为 Fi with Test Data， 在 菜单 选项 右边 尽头 的 空 日 区 域 双击 ， 按 住 command 键 和 t 键 为 
这 个 菜单 添加 快捷 键 吨 T。 


罗 注 意 ” 当 我 这 么 做 的 时 候 ， 我 按 下 了 shift 键 ， 因 为 我 想 要 大 写 的 T。 但 是 这 样 就 会 变 成 快捷 键 人 中 T， 而 这 不 是 我 想 要 的 
结果 。 我 重新 选中 它 ， 按 下 delete 键 ， 现 在 它 的 快捷 键 就 是 delete 键 。 现 在 我 们 应 该 充分 利用 Attributes inspector， 也 就 是 Utility area 
上 部 的 第 四 个 选项 卡 。 当 你 选中 一 个 菜单 选项 的 时 候 ， 最 上 面 的 两 个 栏 位 分 别 是 Title 和 Key Equivalent， 后 面 那 栏 有 一 个 x 按钮 可 


VA vA Io 
19.4.1 Target/Action 


现在 你 想 要 让 菜单 选项 做 些 事 。 束 和 像 在 iOS App RH, SRR STS, BPARTARMSA— TUR (target) & 


送 一 条 信息 (行为 ) 。 你 还 没有 写 对 应 的 方法 ， 但 是 你 可 以 为 它 起 个 名 字 : “fillWithData:” . 


Target 如 何 处 理 ? 如 果 在 Main.storyboard 中 搜索 LeagueDocument 的 引用 将 会 徒 芳 无 功 ， 这 个 类 与 独立 的 文档 相关 联 ， 
而 不 是 应 用 程序 。 对 于 “filWithData:” 来 说 ， 应 该 传 入 什么 Cocoa 对 象 呢 ”我 不 知道 ， 我 想 应 该 是 你 下 意识 中 想到 的 、 任 何 想 
要 对 其 做 出 反应 的 对 象 吧 。 


这 对 Cocoa 来 说 并 不 是 一 个 轧 砂 的 回答 。AppKit 保 持 了 一 个 持续 更 新 的 responder chain (反应 链 ) ， 它 是 用 户 操作 的 一 系 
列 潜在 反应 对 象 。 这 个 反应 链 的 开始 是 “第 一 个 响应 者 ”， 它 可 能 在 前 人 台 窗 口中 选中 的 视图 ， 然 后 传递 到 前 从 窗口 ， 之 后 是 窗口 
的 文档 ， 最 后 到 达 应 用 程序 本 身 。 你 可 能 会 注意 到 ，storyboard 中 的 每 个 场景 都 在 它 的 标题 栏 (当场 景 被 选中 的 时 候 ) 中 ,在 
大 纲 列 表 中 有 一 个 红色 的 万 块 ， 它 表示 First Responder。 用 户 界 面 控 件 可 以 指定 First Responder， 无 论 当 时 它 是 什么 ， 作 为 行 
为 (action) 的 目标 (target) ， 然 后 AppKit 残 会 志 历 反应 链 ， 直 到 它 找到 能 够 处 理 这 个 操作 的 对 象 为 止 。 


wits 反应 链 比 我 们 刚刚 讲 的 要 复杂 。 想 要 了 解 更 多 信息 ， 可 以 查看 Apple 文 档 中 关于 NSApplication、NSResponser 的 内 


容 ， 以 及 相关 的 编程 文章 。 


和 Intetface Buildet 场 景 中 其 他 占 位 符 图 标 一 样 ，First Respondet 并 非 实 际 存 在 于 XIB 中 。 它 是 一 个 代理 ， 是 XIB 中 对 象 与 外 部 
对 象 相 联系 的 一 种 方法 。 还 有 File s Owner， 它 是 导致 编译 的 storyboard 载 入 的 对 象 。First Respondetr， 反 应 链 最 开始 的 地 方 ; 
Application 是 作为 一 个 整体 误 入 应 用 程序 中 的 NSApplication 对 象 。 如 果 你 没有 看 到 Placeholdet， 那 么 单 击 边 栏 底 部 的 方形 按钮 ， 就 
能 展开 图 标 标签 。 


19.4.2 First Responder 


如 果 你 想 要 使 用 control-dragging ( 按 住 control 键 并 拖 动 ) 将 一 个 操作 从 新 菜单 选项 链接 到 First Responder 图 标 上 面 的 
话 ， 不 会 有 用 。lnterface Builder 为 这 个 链接 展示 了 一 个 HUD， 问 你 是 否 要 从 方法 中 选择 其 中 一 个 方法 作为 想 要 的 操作 。 这 个 
列表 中 不 包括 fillWithData: 因为 这 个 方法 是 刚 编 写 的 ， 你 需要 告诉 Interface Builder 这 个 filWithData: 也 是 一 个 可 以 使 用 的 操 
作 。 


Interface Builder 人 允许 你 通过 选择 场景 顶部 的 First Responder 对 象 完 成 这 件 事 ， 或 者 在 文档 大 纲 中 ， 显 示 出 Attributes 
inspector。 碍 看 器 会 显示 一 个 空 表 用 于 响应 者 可 能 回应 的 用 户 定义 的 行为 。 单 击 + 按 钮 ， 选 中 新 行 让 焦点 处 于 表 上 ， 按 下 
return 键 让 Action 标 签 可 编辑 ， 然 后 输入 “fillWithData:”。Type 这 一 列 是 一 个 复合 框 ， 里 面包 含 可 能 发 出 这 项 行为 的 控件 类 
型 ; 你 可 以 保持 黑 认 的 id， 也 残 是 通用 的 对 象 类 型 ， 除 非 你 想 要 1B 人 在 指定 的 对 象 类 型 上 才能 触 皮 这 个 操作 ， 否 则 瓯 保持 id 不 动 。 
我 们 并 不 关心 这 一 点 ，Interface Builder 现 在 知道 它 处 于 storyboard 之 中 ，fillWithData 是 first responder 可 能 会 执行 的 操作 之 


o 


Pit ”在 Appkit 中 ， 操 作 方 法 必须 带 有 一 个 参数 : “fillWithData” ， 后 面 有 个 冒号 而 不 仅仅 是 fllWithData。 名 字 的 区 别 


很 明显 ， 如 果 你 忘 了 冒号 ，IB 会 自动 补 全 。 


现在 ， 你 可 以 用 control-drag 的 方法 将 新 菜单 选项 拖 到 First Responder 上 ，HUD 就 会 包含 “fillWithData:”。 显 示 的 时 候 
甚至 会 滚动 到 fillWithData 附 近 ， 粗 略 的 匹配 选项 的 标签 。 完 成 连接 ， 见 图 19.5。 


> Connection inspector (Utility 区 域 中 的 第 六 个 选项 卡 ) 提供 了 另外 一 种 建立 连接 和 销毁 连接 的 方法 。 选 中 Fitrst 
Responder##Connect inspector. Received Actions 部 分 包含 当 你 control-dragged 到 FR 图 标 时 连接 HUD 相 同 长 度 的 操作 列表 ， 不 过 这 里 
更 大 ， 也 更 容易 上 下 滚动 。 每 个 选择 器 穷 边 都 有 一 个 泡 泡 ， 将 这 个 泡 泡 拖 动 到 菜单 上 就 会 建立 这 个 连接 ， 标 签 标 识 这 个 连接 的 位 


置 。Connection 旁 边 的 x 按钮 可 以 让 你 销毁 这 个 connection。 
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A195 “将 菜单 选项 Control-dragging First Responder}, 就 会 生成 一 个 提示 窗口 其 中 包含 “fillWith Data: ~ 





到 Frist Respondet 的 操作 方法 仓库 中 


19.4.3 ”将 数据 载 入 LeagueDocument 


HWV 


HA 


， 这 个 方法 就 会 添加 


导入 .csv 文 件 很 简单 ， 大 多 数 工 作 在 制作 iOS 应 用 的 时 候 已 经 做 过 一 遍 了 。 将 sample-data.csv 添 加 到 项 目 中 ， 编 辑 


LeagueDocument.swiftFayfillWithData(), 


@IBAction 
func fillWithData (sender: AnyObject) { 
let mainBundle = NSBundle.mainBundle() 
if let csvPath = mainBundle.pathForResource ( 


"sample-data", ofType: "csv") { 


var error: NSError? = nil 

let success = Game.loadGames (csvPath, 
context: self.managedObjectContext, 
error: &error) 


将 @1BAction 指 向 fillWithData()， 告 诉 Xcode 这 个 函数 可 以 灵活 地 接受 来 自 UI 元 素 的 命令 。 相 应 地 ，Xcode 在 声明 旁边 的 
边栏 上 添加 了 连接 气泡 。 如 果 你 将 LeagueDocument.swift 放 到 Main.storyboard 的 辅助 编辑 器 中 ， 那 么 你 就 可 以 将 气泡 拖 到 任 


总 元 素 上 友 送 一 条 命令 : 菜单 选项 、 按 钮 ， 触 友 控 件 将 会 触 友 对 应 的 操作 。 


在 这 个 例子 中 ， 连 接 气泡 没有 填充 。Edit 一 Fil with Test Data (¢6T) 这 个 命令 会 发 送 到 First Responder 上 ， 而 不 是 文档 
本 身 。 无 法 精确 显示 特定 亢 数 上 面 的 链 搁 ， 因 为 Xcode 知 道 ， 啊 应 器 链 可 能 会 触 友 另 外 一 个 首先 实现 了 fillWithData(0 阔 数 的 对 
象 。 


19.4.4 适应 托管 文档 


对 于 Passer Rating 来 说 ， 我 们 在 应 用 程序 委托 中 建立 了 Core Data 栈 。 这 也 很 容易 理解 : 整个 应 用 程序 仅 有 一 个 数据 来 
源 。 


将 OS X 应 用 程序 构建 在 以 Core Data 为 基础 的 文档 上 是 另外 一 件 事 。 每 个 文档 都 有 它 自 己 的 和 存储， 通过 LeagueDocument 
对 和 象 的 父 类 NSspPersistentDocument 管 理 。NSPersistentDocument 很 懒惰 : 在 它 托管 对 象 的 上 下 文中 ， 你 可 以 执行 尽 可 能 多 的 
Core Data 操 作 ， 但 是 其 后 的 数据 存储 并 没有 创建 ， 直 到 文档 第 一 次 保存 的 时 候 才 会 创建 。 


第 一 次 存储 操作 什么 时 候 友 生 ? 你 不 知道 。Xcode 的 项 目 模 板 的 初始 App 束 包含 目 动 存储 、 状 态 恢复 以 及 现代 应 用 程序 的 版 
本 行为 预 信 。 用 户 可 以 在 工作 进度 到 达 一 定 程度 或 者 为 文档 命名 时 请 求 (request) 存储 操作 ， 但 是 在 那 之 前 ， 系 统 会 将 内 容 存 
储 在 用 户 的 Library/ 文 件 夹 中 ， 即 使 是 一 个 “未 命名 ”文档 。 


直到 触发 第 一 次 自动 保存 操作 ，Core Data 上 下 文 还 没有 分 配 存储 空间 ， 此 时 调用 save() 方 法 写 入 内 容 将 会 导致 异常 发 生 。 
Passer Rating 初 始 时 有 一 个 数据 文档 ， 可 以 周期 性 地 将 托管 对 象 的 上 下 文 周 期 性 地 写 入 Game.loadGames() 中 ， 但 是 Mac 
Passer Rating 无 法 这 样 做 。 


编辑 loadGame0)， 它 已 经 不 再 需要 写 入 数据 存储 的 功能 


public 
class func loadGames (csvFilePath: String, 
context: NSManagedObjectContext, 
error: NSErrorPointer) 
-> Bool 


let csvFile = SimpleCSVFile(path: csvFilePath) 
var parsingError: CSVError? = nil 


parsingError = csvFile.run { (values) in 
let newGame: Game! = Game (managedObjectContext: context) 
assert (newGame != nil, "Could not create a Game") 


let passer:Passer = Passer.passerWithFirstName ( 
values["firstName"]!, 
last: values ["lastName"]!, 
context: context) 


passer. enqueueGame (newGame) 


passer.currentTeam = values["ourTeam"] ! 


for key in allGameNumericAttributes { 
newGame.setValue (values [key] !.toInt(), 
forKey: key) 


} 
newGame.team = 

Team. teamWithName (values ["ourTeam"]!, 

context: context, create: true)! 
newGame.theirTeam = values["theirTeam"] ! 
newGame.whenPlayed = DATE from_yyyy_MM dd 

(values ["whenPlayed"] ) 

return nil 


if let pError = parsingError { 
if error != nil { error.memory = pError.nsError } 


return false 


Passer. flushGameQueues (context: context) 
return true 


同样 ， 我 将 sample-data.csv 的 数据 分 割 成 8 个 赛季 ， 第 16 草 中 我 们 有 40 个 。 我 们 通过 了 稳定 性 测试 。 


O:a F) FP DATE FH A ERATE RY AG PRAJ AAEE LE Utilities.swiftt, H Unicode% t 4 F AHH H 
期 表示 日 历 页 。 我 太 欢乐 了 。 


19.4.5 ”测试 命令 


以 上 的 工作 足 可 以 让 你 看 到 菜单 命令 是 否 可 以 正常 运行 。 在 “fillWithData:” 的 起 始 位 置 设置 一 个 断 点 ， 运 行 Mac Passer 
Rating。 信 助 Yosemite 恰 当 的 状态 恢复 机 制 (在 Scheme 编 辑 器 的 Run 面 板 下 的 Options 选 项 卡 中 可 以 关闭 它 ) ， 当 你 首次 运行 
的 时 候 ， 你 可 能 会 看 到 文档 窗口 ， 如 果 没 有 看 到 ， 那 么 使 用 兄 NN 快 捷 键 创建 一 个 新 文档 窗口 。 保 存 这 个 文档 (可 以 使 用 任意 名 
称 ， 保 存在 任意 地 方 ) 。 然 后 选择 Edit 一 Fill with Test Data (¢6T) 命令 。 


加 注意 ”如 果 这 个 命令 是 灰色 的 (未 激活 ) 无 法 使 用 ， 那 么 检查 Main.storyboard 查 看 它 是 否 已 经 连接 到 T First Responder. 
AppKit 仅 会 在 响应 链 中 实现 了 行为 对 应 的 方法 的 时 候 才 会 激活 一 个 菜单 项 。 


使 用 这 个 命令 后 会 故 生 两 件 事 。 首 先 ， 在 “fillWithData:” 起 始 处 设置 的 断 点 会 被 触 友 ， 所 以 你 会 意识 到 菜单 项 已 经 可 以 下 
常 工 作 了 。 第 二 扣 ， 如 果 继 续 向 下 执行 ， 那 么 标题 栏 将 会 添加 灰色 的 Edited 标 识 ， 以 此 显示 这 个 命令 已 经 导致 文档 的 内 容 友 生 了 
更 改 ， 即 使 你 看 不 到 更 改 的 具体 内 容 。 


现在 保存 这 个 文档 ， 使 用 File 一 Savehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (46S) 命令 。 使 用 这 个 命令 可 以 看 到 预期 的 保 
仔 文 件 的 界面 ， 但 是 你 可 能 对 弹出 菜单 中 的 File Format mA. iost, Core Data 会 被 存储 为 SQLite 数 据 局 文件 。 在 OS 
X 中 ，Core Data 有 3 种 存储 类 型 : SQLite、Binary 和 XML。 


. SQLite 是 所 有 格式 中 最 实用 的 一 个 。 它 的 存 取 速 度 很 快 ， 能 处 理 成 千 上 万 条 数据 。SQL 层 为 你 提供 了 非常 复杂 的 搜索 关键 
字 和 统计 性 操作 (比如 (Csum， 统 计 一 个 Passet 参 与 的 所 有 Game 中 的 全 部 completions 数 据 ) o 


“但 是 对 于 少量 的 数据 集 来 说 ，SQLite 文 件 太 过 笨重 ,无 法 充分 利用 数据 库 的 高 效 存 储 。Binatry 格 式 提 供 了 一 个 压缩 格式 ， 
对 于 小 型 数据 集 来 说 它 的 存 取 速 度 非 常 快 。 不 过 ， 它 没有 提供 像 数 据 库 那 样 复杂 的 查询 和 计 章 功能。 


-XML 存储 足够 胜任 小 型 的 数据 集 ， 但 是 它 实 际 上 主要 用 于 调试 : XML 的 格式 肉眼 可 读 ， 所 以 你 可 以 写 入 足够 多 的 记录 和 
关系 ， 用 来 练习 你 想 探索 的 特性 ， 以 及 存储 介质 如 何 反 应 它 。 


按照 不 同 的 格式 存储， 你 会 分 别 得 到 后 缀 为 .sqlite、.binary 和 .xm 的 文件 ， 但 是 它们 并 没有 和 你 的 App 关 联 在 一 起 ， 对 于 大 
多 数 用户 来 襄 ， 同 时 提供 3 种 不 同 的 仓储 类 型 也 没什么 吸引 力 。 


194.6 ”为 League 数 据 确 定 一 个 类 型 


将 应 用 程序 与 其 操作 的 文件 类 型 相对 应 是 Info.plist 的 功能 。Target 编 辑 器 ( 单 击 Project 导 航 器 最 顶端 的 这 一 行 ， 确 保 Mac 
Passer Rating target 被 选中 ) 在 Info 选 项 卡 下 提供 了 一 个 特殊 的 编辑 器 。 我 们 感 兴趣 的 类 别 是 Document Types， 它 描述 了 一 
个 文档 文件 如 何 与 应 用 程序 相关 联 ; 还 有 Exported UTls， 它 描述 了 一 般 情 况 下 系统 如 何 处 理 这 类 文件 。 


单 击 它 们 的 提示 三 角 ; 我 们 将 会 为 League data 添 加 一 个 Uniform Type Identifier (UTI) ， 并 且 将 文档 的 类 型 指向 UTI 的 
引用 ， 见 图 19.6。 


Y Document Types (1) 
League File 
Name League File identiier com.wt9t.league 


No 
Class $(PRODUCT_MODULE_NANAg Role Editor Ed 


Extensions Non Mime Types | 


icon Non | Bundle | | Document is distributed a... 


> Additional document type properties (0) 


十 


Y Exported UTIs (1) 


League File 


Description League File Extensions leaguedoc 
) ldentifiaer com.wt9t.league Mime Types application/octet-stream 


A Icon League I Phoard Types None 


Conforms To public.data OS Types None 


Reference URL None 


Y Additional exported UTI properties (1) 


Core Data persistent store type = ! SQLite 


T 





图 19.6 ”基于 文档 的 Core Data 应 用 程序 模板 仅 根 据 应 用 定义 了 文档 文件 。 它 明确 区 分 了 类 型 定义 (针对 Uniform Type Identifier 的 


定义 ) 和 文档 定义 ( 它 声 明了 Mac Passer Rating， 特 别 的 是 ， 它 带 有 League 文 件 ) 
让 我 们 从 UTI 开 始 ， 首 先 为 League 文 件 的 内 容 定 义 类 型 ID com.wt9t.league， 一 个 League 文 件 包 括 : 
- League File 的 Desctition， 它 会 在 Findet 中 显示 为 文件 类 型 。 


Identifiet 为 com.wt9t.league。 


- 名 为 League 的 Icon， 之 后 会 将 它 添 加 到 Images.xcassets 中 。 


- 类 型 为 Conforms To public.data。UTIs 被 定义 为 已 知 类 型 的 升级 。 比 如 ， 一 个 不 知道 如 何 处 理 XML 属 性 列表 的 系统 可 能 会 求 
助 于 com.apple.prtoperty-list、public.xml、public.data (一 个 比特 流 ) 或 者 public.item (“ 菜 些 事 或 者 其 他 事 ”) 。 


UITSs 最 有 用 的 引用 在 UTType.h 和 UTCoreTypes.h 中 。 命 令 行 open-h UTType.h 将 会 找到 一 个 头 文 件 ， 并 在 默认 的 C 头 文件 
编辑 器 中 打开 它 。 如 果 你 习惯 用 其 他 应 用 打开 ， 那 么 添加 -a applicationName 命 令 。 





可 能 只 有 一 个 leaguedoc。 不 要 包含 后 面 的 喜 号 。 不 可 思议 的 是 ， 应 用 程序 目标 模板 想 要 一 个 扩展 ， 但 是 却 
从 来 没有 在 任何 地 方 记 录 它 。 


- Extensions 


i 





- Mime Types 使 用 最 常见 的 application/octet-stream。 


- 你 不 能 公布 一 个 类 型 的 引用 作为 Reference URL; 你 不 想 将 数据 保存 在 粘贴 板 中 ， 所 以 你 不 需要 Pboard Types. E IAA H 
ZH 


RE, ZA MOS X 文 档 类 型 标识 符 (OS Types) 都 不 支持 。 将 这 些 都 留 白 。 


一 个 League 文 件 将 会 是 一 个 SQL Core Data 和 存储 文件 ， 同 时 你 也 看 到 了 ， 它 是 文档 的 一 种 特殊 格式 。 打 开 Additional 
exported UTI properties 子 视图 ， 然 后 单 击 其 中 的 表 。 在 Key 这 一 列 输入 Core， 你 应 该 提供 完整 的 Core Data persistent store 
type， 设 置 为 String 类 型 ， 同 时 选择 SQLite 作 为 Value。 


19.4.7 ”确定 App 如 何 处 理 League 文 件 


Document Types 条 目 现 在 已 经 简化 为 描述 Mac Passer Rating 如 何 处 理 League 文 档 ， 加 上 系统 级 别 细 节 的 
com.wt9t.leagu 的 引用 。 


` 单 击 每 一 个 条 目 右 上 部 的 x 按钮 ， 移 除 所 有 Additional document type propetties。UTI 提 供 了 这 个 信息 。 


` 


- Name — K 5 League File。Findet 使 用 Launch Setvices 的 时 候 ， 如 果 没 有 定义 UTI， 那 么 将 会 使 用 这 个 字符 串 显 示 文 件 类 


型 。 但 是 这 个 名 称 仍 然 用 于 NSDocument 系 统 作 为 内 置 的 App 标 签 显示 文档 类 型 。 
- Uniform Type Identifier com.wt9t.league o 


:Class 将 会 告诉 AppKit 哪 个 NSDocument 类 用 来 处 理 这 个 文档 类 型 。 你 基本 上 不 需要 亲自 写 分 配器 。 这 一 项 会 告诉 载 入 


ane 


>» 


类 的 名 称 为 NSDocumentController， 什 么 可 以 用 来 实例 化 (在 我 们 的 例子 中 ) 一 个 LeageueDocument 对 象 ， 什 么 可 以 处 理 好 读 取 、 
展示 和 书写 的 问题 。 


` 它 用 来 简化 类 的 名 称 ， 但 是 Yosemite 引 入 了 模块 ， 它 隔离 了 一 个 应 用 程序 中 各 个 库 里 的 类 名 。LeagueDocument 完 整 的 名 称 
7 Mac_passet_tating. LeagueDocument. 点 号 之 前 都 是 模块 的 名 称 ， 标 识 这 个 类 作为 应 用 程序 主要 模块 的 一 部 分 ， 它 的 名 称 在 应 用 


程序 之 后 ， 非 字母 的 符号 用 下 划 线 代替。 


- App 产 品 的 名 称 在 开发 过 程 结 束 后 可 能 会 更 改 ， 所 以 Xcode 将 产品 的 名 称 用 
3$PRODUCT_ MODULE_NAME).LeagueDocument 表 示 。 当 Info.plist 被 复制 到 应 用 程序 包 中 的 时 候 ， 构 建 变量 


PRODUCT _ MODULE_ NAME 将 会 使 用 当前 的 名 称 填充 。 


- Mac Passer Rating*} J-League files 的 Role 来 说 是 一 个 Editof。 这 样 当 用 户 双 击 文件 图 标 或 者 选中 Findet 的 File 一 Open With 菜 单 
的 时 候 ， 就 会 知道 发 生 了 什么 。 一 个 “查看 器 ”App 可 以 读 取 文 件 ， 并 将 文件 内 容 转换 成 它 能 保存 的 文本 ; 一 个 “编辑 器 ”能 打 
开 、 保 存 并 创建 文本 ; none 意 味 着 当 文 件 与 这 个 App 相 关联 的 时 候 一 一 App 可 能 会 定义 文件 的 图 标 和 类 型 一 一 它 不 是 一 个 文档 ， 


当 双 击 文件 的 图 标 时 ， 不 应 该 打开 这 个 文件 。 


“ 你 不 得 不 提供 UTI， 或 者 一 个 Extensions 列 表 ， 或 者 针对 文档 类 型 的 Mime Types。 我 们 有 一 个 UTI， 所 以 其 他 两 部 分 都 留 


Wy 


. 不 需要 定义 一 个 Icon， 因为 UTI 已 经 定义 了 。 


. WZA i&Bundle:Document is distributed as abundle。 包 文档 在 Findet 中 看 起 来 像 是 一 个 独立 的 图 标 ， 但 是 事实 上 它 是 一 个 包 


含 文档 组 成 的 文件 夹 。 我 们 在 这 里 不 探讨 这 个 问题 。 第 22 章 会 告诉 你 更 多 内 容 。 


19.4.8 ”应 用 程序 和 文档 图 标 


之 前 我 曾经 让 你 将 com.wt9t.league 的 图 标 设置 为 League。 作 为 本 章 的 准备 工作 之 一 ， 我 将 一 系列 应 用 程序 图 标 和 文档 图 
标 放 在 了 一 起 ， 见 图 19.7。 在 你 编辑 Images.xcassets 的 时 候选 择 了 Editor 一 New OS X Icon， 那 么 你 就 会 看 到 一 张 带 有 5 个 点 大 
小 的 图 片 集 ， 其 中 包含 单 分 辨 率 和 双 分 辨 率 。 这 些 都 会 编译 到 一 个 icon-set.icns 文 档 中 ， 当 Finder 需 要 演 染 这 些 图 标的 时 候 ， 它 


会 先 选择 最 合适 的 那 一 张 。 


aa aa DOH OH 


32pt 





图 19.7 ”包含 10 张 图 片 的 OS 和 完整 图 标 套件 。 在 实际 使 用 中 ， 部 分 尺寸 可 以 忽略 ， 一 种 尺寸 的 双 分 状 率 图 片 可 以 复制 一 份 作为 单 
分 辨 率 下 一 尺寸 的 图 上 


理想 情况 下 ， 每 个 图 片 都 应 该 按照 它 的 使 用 目的 精心 制作 ， 大 图 标 要 显示 出 足够 的 细节 ， 小 图 标 要 能 看 到 清晰 的 轮 慷 。 这 些 
选择 将 会 反映 在 两 个 分 状 率 的 各 个 尺寸 当中 ， 忆 共 是 10 张 图 片 。 


在 实际 使 用 中 ， 当 2x 图 片 的 某 种 尺寸 与 1x 图 片 有 相同 的 像素 数 的 时 候 ， 人 们 通 弟 会 使 用 相同 的 图 片 。 他 们 从 相同 的 向 量 绘 
制 中 创建 位 图 。 如 果 你 仅仅 是 按照 原样 使 用 ， 那 么 无 法 得 到 一 张 128x128 的 图 片 ， 只 能 接受 OS 目 动 放大 或 者 缩小 这 张 图 片 。 


DER 如 果 你 能 使 用 PDF 夭 量 泻 染 一 张 图 片 ， 那 么 就 会 有 更 好 的 选择 : 图 片 的 Attributes 查 看 器 中 的 一 个 选项 可 以 将 图 片 
集合 设置 A Image Set: Types o 在 弹出 框 中 选择 Vectorfs ， 将 图 片 集合 减少 为 单个 的 Universal 选 项 。 这 样 做 的 结果 就 是 能 和 提供 的 位 
图 一 样 清晰 。 注 意 ， 这 种 泻 染 方式 也 会 缩放 线条 ， 所 以 大 视图 中 的 三 点 线 会 变 成 小 视图 中 的 小 细 线 。 有 的 时 候 可 能 期 待 的 就 是 这 


样 ， 有 的 时 候 却 不 是 。 


其 中 一 个 图 片 集 包 含 Passer Rating 的 商标 ， 它 会 重 赤 在 一 张 一 般 的 文档 图 标 上 。 我 将 这 个 集合 命名 为 League。 当 构建 Mac 
Passer Rating 的 时 候 ，Xcode 会 从 文件 集中 生成 League.icns， 并 在 应 用 程序 包 中 包含 它 。 


不 过 ，.icns 文 档 尽 在 完成 的 应 用 程序 中 存在 ;在 项 目 文 件 夹 中 找 不 到 。 当 你 在 lcon 栏 中 输入 League 的 时 候 ，Xcode 将 会 显 
示 一 个 灰色 的 问号 。 另 一 方面 ， 如 果 你 自己 (在 Xcode 包 的 Graphics Tools 中 ， 有 一 个 lcon Composer 应 用 可 以 完成 这 件 事 ) 


包含 了 .icns， 你 也 能 将 它 放 在 图 片 中 ，Xcode 会 将 这 个 文档 添加 到 项 目 中 。 


文件 清单 看 起 来 应 该 像 图 19.6 的 底部 所 示 ， 这 个 清单 是 专门 针对 Mac Passer Rating 的 。 现 在 ， 当 你 保存 一 个 League 文 件 
的 时 候 ，Finder 融 会 友 现 它 与 应 用 程序 的 天 系 ， 然 后 显示 出 对 应 的 内 容 ， 见 图 19.8。 


> A League doc Into 


- A League doc 


Modified: Today. 9:58 PM 





Y Name å Extension: 


A League doc. leaguedoc 





Hide extension 





F Comments: 


Y Open with: 





4) Mac Passer Rating (default) 


Use this application to open all documents like this 
one. 





Y Preview: 


图 19.8 填充 文档 类 型 说 明文 件 需 要 提供 一 个 名 称 和 文档 类 型 的 图 标 


19.5 小结 


本 章 基 于 OS X 版 本 的 passer-rating 项 目 ， 介 绍 了 一 些 新 的 Xcode 技术 。 为 了 完成 这 个 目的 ， 你 需要 做 一 些 转换 : 创建 了 一 
个 基于 文档 的 Core Data application， 然 后 导入 已 经 存在 的 代码 。 


你 看 到 现在 的 Mac 应 用 程序 都 是 从 至 少 有 两 个 根 场景 的 storyboard 上 构建 而 成 : Application 场 景 ， 它 包含 主 菜单 栏 和 应 用 
程序 委托 ;还 有 控制 器 ， 用 于 App 的 文档 窗口 。 这 就 引发 了 一 个 难题 一 一 当 App 级 别 的 工具 (菜单 命令 ) 需要 与 指定 的 文档 通信 
的 时 候 ， 需 要 怎么 做 。 解 决 方法 是 : 当 屏 幕 可 能 包含 太 多 内 容 的 时 候 ， 需 要 编辑 说 明文 档 的 内 容 。 你 学 习 了 First Responder 如 
何在 Interface Builder 中 作为 代理 的 功能 ， 以 及 响应 链 如 何 连 接 中 上 间 的 沟 均 ，。 





最 后 ， 我 们 调整 了 Mac Passer Rating 必 须 与 OS X 系 统 策 略 合作 的 方式 ,保存 和 显示 文件 : 因为 OS 会 自动 保存 文件 ， 所 以 
我 们 让 Core Data 也 自动 保存 。 我 们 也 对 文档 格式 做 出 了 选择 ， 确 定 Mac Passer Rating 的 联盟 文件 属于 应 用 程序 ， 同 时 采用 了 
有 特色 的 图 标 。 


P20 HPE: 连接 OS X 应 用 程序 


如 果 重 新 审视 图 19.1， 你 会 友 现 即使 Mac Passer Rating 使 用 最 简洁 的 方式 ， 它 也 会 有 多 于 20 个 信息 用 在 4 个 界面 上 显示 、 
AT, mA ( 某 些 情况 下 ) 以 及 更 新 。 这 样 会 引入 大 量 的 见 余 、 重 复 的 代码 还 有 大 量 通过 网 络 对 象 通信 的 结构 ， 对 吗 ? 


7x, AppKit (Coca 中 Mac 特 定 的 部 分 ) 提供 了 一 个 工具 叫 作 bindings ( 绑 定 ) ， 它 由 NSController 提 供 支 持 ， 当 你 第 一 次 
使 用 这 个 工具 的 时 候 ， 你 会 友 现 它 难以 拉 摸 ， 但 是 一 旦 掌握 ， 殊 能 大 大 减轻 代码 的 负担 ， 达 到 事半功倍 的 效果 。 





局 注意 ”有 经 验 的 Mac 程 序 员 包括 Apble 本 身 一 一 都 会 警告 你 : bindings 是 一 个 高 级 特性 。 如 果 这 是 一 本 关于 AppKit 的 
书 ， 我 用 嘿 叶 的 话 教 给 你 的 是 “入 门 ” 这 一 部 分 内 容 。 本 书 的 目标 是 告诉 你 如 何 充分 利用 Interface Buildet 的 优势 来 支持 bindings 的 
功能 ，bindings 是 非常 重要 的 特性 。 


20.1 OS X 中 的 Storyboard Segue 


Applei 让 Yosemite 操 作 系统 和 Xcode 5 中 的 应 用 程序 可 以 使 用 storyboard。 朱 面 应 用 程序 控制 器 之 间 的 关系 比 移动 应 用 程 


序 之 间 关 系 复杂 得 多 : 10S 视 图 控制 器 中 大 多 数 segue 都 被 替换 为 一 个 全 屏 的 控制 器 。 你 可 以 在 另外 一 个 场景 中 嵌入 一 个 控制 
器 ， 但 这 种 做 法 只 是 为 了 方便 而 不 是 为 了 需求 使 然 。 


但 是 在 OS X 系 统 中 这 么 做 很 困难 。 应 用 程序 窗口 通 弟 摘 述 了 文档 的 全 部 内 容 ; 它们 包含 大 量 分 散 显 示 的 内 容 。Yosemite 希 
望 这 些 普通 的 窗口 由 多 个 视图 控制 器 组 成 ， 每 个 控制 器 反 过 来 也 包含 其 他 的 控制 器 。 在 iO0S 场 景 中 包含 是 一 个 很 重要 的 功能 ; 6 
是 OS X 场 景 的 基本 构成 要 素 。 命 名 的 segue 将 子 场景 与 父 场景 链接 在 一 起 ， 残 像 is 中 的 转换 segue。 


让 我 们 化 一 点 时 间 研 究 下 将 众 入 的 所 有 视图 控制 器 一 次 性 放 在 界面 中 育 后 的 策略 。 完 成 这 件 工作 后 ， 我 想 要 寺 论 下 League 
窗口 的 结构 ， 束 好 像 我们 已 经 制作 完成 了 这 个 窗口 ， 因 为 这 对 从 一 开始 理解 如 何 调节 几 近 独立 的 OS X 视 图 控制 器 本 质 和 专注 于 
数据 的 需要 很 重要 。 本 草 将 会 仔细 介绍 如 何 处 理 这 个 问题 。 我 们 有 很 多 事情 要 做 ， 奖 励 是 什么 ? 


并 不 是 storyboard 场 景 中 的 每 一 段 天 系 都 是 一 个 segue。 之 前 在 iOS 中 ， 你 会 看 到 UIlNavigationController 的 根 控制 器 关系 
并 没有 在 任何 地 方 触 发 一 个 prepareForSegue( ,sender:)， 它 更 像 填 充 导航 控制 器 的 rootViewController 属 性 ， 例 如 @1IBOutlet 
的 功能 


你 会 看 到 很 多 segue 并 不 在 OS X 的 storyboards 中 ， 因 为 在 单个 窗口 中 存在 多 个 视图 控制 器 很 常见 。 在 ain 
口中 ， 有 3 个 视图 控制 器 : 窗口 控制 器 的 窗口 包含 一 个 拆 分 视图 控制 器 一 一 Interface Builder 会 在 分 拆 场景 和 窗口 乙 间 画 一 
线 。 反 过 来 ， 分 拆 视 图 的 两 部 分 将 会 连接 到 图 例 视图 控制 器 ， 用 于 显示 league 列 表 和 team 细 三 。 


这 些 续 表 示 的 关系 没有 触 友 及 送 到 父 控制 器 的 prepareFor9egue(wsender) 消 息 。 你 不 能 为 它们 命名 。 事 实 上 ， 它 们 根本 融 
没有 配置 一 一 当 你 选中 其 中 一 个 的 时 候 ， 会 友 现 Attributes 查 看 器 是 空 的 。 


还 有 第 二 个 因素 : NSDocument 以 及 LeagueDocument 会 载 入 窗口 控制 器 ， 它 们 在 storyboard 中 展示 其 内 容 ， 并 使 用 
addWindowController 绑 定 控制 器 到 它 目 身 。 当 控制 器 准备 好 接收 其 内 容 的 时 候 ， 却 没有 开始 控制 : Window 控 制 器 会 延迟 载 
入 其 内 容 。 文 档 可 以 将 目 身 的 数据 传递 给 控制 器 ,但 是 控制 器 还 没有 准备 好 泻 染 ， 因 为 窗口 和 它们 的 组 成 视图 并 不 存在 。 只 有 当 
一 些 应 用 程序 事件 调用 将 它们 展现 在 界面 上 ， 或 者 一 些 消 数 问 询 控 制 器 窗口 属性 的 时 候 ，AppkKi 革 会 实例 化 它们 及 其 视图 结 
构 ， 如 果 需 要 ， 还 会 实例 化 子 视图 控制 器 的 链 。 


» 注意 ”开发 者 通常 会 使 用 调用 window 并 将 实际 值 丢弃 (windowControllerwindow) 的 方法 来 加 大 多 窗口 实例 化 的 控制 。 


一 旦 窗口 存 企 ， 控 制 器 束 可 以 从 中 接收 数据 ， 而 不 用 特殊 的 万 法 接收 数据 ， 它 只 需要 等 待 将 数据 推送 到 视图 层 即 可 。 当 控制 
器 和 视图 都 准备 就 绪 的 时 候 ， 文 档 对 象 就 会 收 到 windowControllerDidLoadNib( )。 参 数 将 会 指向 控制 器 ， 所 以 文档 可 以 将 它 
的 数据 放 到 控制 器 中 。 控 制 器 返回 来 会 将 数据 打包 到 子 控制 器 及 视图 。 


St ”有 一 个 很 诱 人 的 想法 : Interface Builder 应 该 可 以 直接 将 一 个 文档 或 者 窗口 控制 器 通过 CIBOutlets 连 接 到 它 的 子 控 
制 器 。 这 样 做 非常 简单 ， 也 很 直接 ， 不 过 你 需要 花费 数 小 时 弄 明 白 如 何 完成 这 个 工作 (就 像 我 之 前 做 的 ) ， 以 及 为 什么 文档 不 会 
告诉 你 如 何 做 。 我 来 回答 这 个 问题 : IB 不 会 让 你 这 样 做 的 。 还 记得 在 iOS 中 ， 你 无 法 穿 起 视图 控制 器 之 间 的 outlet。 在 这 里 也 一 
样 ， 视 图 控制 器 出 现在 界面 上 的 时 候 无 法 更 改 它 。 你 不 得 不 在 运行 时 处 理 好 所 有 的 关系 。 这 一 点 并 不 明显 ,但 是 一 旦 你 接受 了 
它 ， 也 就 没 那 么 难 。 


我 们 将 会 使 用 另外 一 种 方法 。 所 有 的 LeaguWindowController 需 要 在 每 个 NSPersisten tDocument 都 有 的 
NSManagedObjectContext 中 接收 所 有 的 文档 内 容 。 其 他 内 容 都 可 以 根据 内 容 获得 。 窗 口 可 以 得 到 托管 对 象 上 下 文 ， 因 为 它 的 
文档 属性 在 添加 到 文档 控制 器 列表 的 时 候 融 已 经 设置 好 了 。 另 一 方面 ， 它 可 以 从 分 拆 视图 控制 器 得 到 league 和 team 子 控制 器 。 


20.2 ”构建 文档 窗口 


因为 我 们 知道 控制 器 层级 中 的 每 一 层 人 至 少 都 可 以 看 到 它 目 身 包含 的 视图 和 控制 器 ， 当 我 们 载 入 视图 控制 器 、 实 例 化 它们 的 窗 
O (或 者 视图 ) ， 并 将 它们 所 需 的 数据 通过 文档 链 获 得 后 ， 融 拥有 了 所 有 需要 的 控件 。 


20.2.1 RABO 


LeagueDocument.swift 中 的 makeWindowControllers() 方 法 非常 直接 : 它 实例 化 了 标识 为 League Window Controller 
的 控制 器 ， 并 且 将 它 添加 到 窗口 控制 器 列表 中 。 


var windowController: LeagueWindowController! 
override func makeWindowControllers() { 
let storyboard = NSStoryboard(name: "Main", bundle: nil)! 
windowController = storyboard 
-instantiateControllerWithIdentifier ("LeagueWindow") 
as! LeagueWindowController 
addWindowController (windowController) 


instantiateController 方 法 载 入 了 窗口 控制 器 和 storyboard 中 的 窗口 。 在 方法 返回 之 前 ，LeagueWindowController 得 到 了 
它 的 windowDidLoad 消 息 。 它 抓 住 了 这 个 机 会 捕获 了 其 中 包含 的 视图 控制 器 ， 马 上 我 们 会 了 解 更 多 。 


// Use this as an ID tag for notices that a Team has been selected. 
// It's passed as part of the addObserver(...) call, 

// which will be explained later. 

typealias KVOContext = UInt16 

var teamSelectionChange = KVOContext (12) 


// For the first part of this chapter, the league window will be 
// relatively simple. windowDidLoad() will have to do more once 
// the content of the window develops. When needed, change 

// usingSplitView to ‘true to unmask the full functionality. 
private let usingSplitView = false 


var splitViewController: NSSplitViewController! 
var leagueViewController: LeagueViewController! 


// Uncomment this line when the split view and the team-detail 
// view are added to the window: 
// var teamDetailController: TeamDetailController! 


// 


override func windowDidLoad() { 


if usingSplitView { 
// Top-level controller in the window is the split controller 
splitViewController = contentViewController 
as! NSSplitViewController 


// First item in the split controller is the team list 
var splitiItem = splitViewController.splitViewlItems [0] 
as! NSSplitViewItem 
leagueViewController = splitItem.viewController 
as! LeagueViewController 
} 
else { 
leagueViewController = contentViewController 
as! LeagueViewController 


// Watch the Team table for changes to the selection. 
// More on this later. 
leagueViewController.teamArrayController.addObserver ( 
self, forKeyPath: "selectedObjects", 
options: NSKeyValueObservingOptions (0), 
context: &teamSelectionChange) 
if usingSplitView { 
// The second item in the split controller is the team details 
splitItem = splitViewController.splitViewItems [1] 
as! NSSplitViewItem 
teamDetailController = splitItem.viewController 
as! TeamDetailController 


在 LeagueWindowController 连 接 了 它 的 组 件 之 后 ， 控 件 返 回 了 LeagueDocument， 它 调用 addWindowController 完 成 
到 窗口 控制 器 的 链接 。 这 个 过 程 包 含 设置 窗口 控制 器 的 document 属 性 。 现 在 LeagueWindowController 已 经 知道 了 它 的 文档 ， 
然后 残 可 以 获得 这 个 文档 的 托管 对 象 上 下 文 环境 ， 同 时 将 它 向 下 传递 给 LeagueViewController， 这 需要 MOC， 所 以 它 能 从 
LeagueDocument 的 Core Data 存 储 中 获得 team 记 录 。 


override var document: AnyObject? { 
didSet { 
if let document = document as? LeagueDocument { 
leagueViewController.managedObjectContext 
= document .managedObjectContext 


20.2.2 RWE 


首先 ，Mac Passer Rating 应 该 有 能 显示 数据 的 位 置 ， 一 个 简单 的 表 用 来 展示 team 名 称 以 及 设 team 及 对 手 获 得 的 总 分 数 。 
LeagueViewController 可 以 完成 这 个 工作 。 


Main.storyboard 中 的 视图 场景 包含 一 个 标签 : Your document contents， 所 以 它 不 为 空 。 删 除 这 个 标签 。 打 开 Utility 区 
域 (第 三 个 选项 卡 ， 圆 图 中 有 个 方块 ) 下 面 的 Object 库 ， 然 后 搜索 table。 将 Table View 拖 到 LeagueViewController 场 景 
拖 到 场景 中 的 视图 看 起 来 与 OS 中 的 UlTableView 一 样 简单 。 但 实际 上 并 非 如 此 。UlTableView 是 UlScrollView 的 一 个 子 类 
管理 了 表 的 各 个 方面 ， 而 不 仅仅 针对 你 这 个 应 用 程序 。 


拖 到 场景 中 的 AppKit 表 看 起 来 很 简单 ， 但 是 如 果 你 查看 文档 大 纲 ， 你 就 会 发 现 它 是 一 个 树 形 视图 ， 大 概 有 7 层 深 ， 见 图 
20.1。 根 节点 是 一 个 滚动 视图 ， 它 包含 一 个 滚动 栏 ， 一 个 clip view 在 滑动 的 时 候 用 来 管理 表 本 身 的 。 另 外 还 有 一 个 表 头 ， 它 
在 “ 滩 动 视图 ”中 ， 因 为 它们 不 需要 深 动 。 
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图 20.1 从 对 象 库 中 拖 出 来 的 表 视 图 相当 简单 ， 它 实际 上 是 一 个 包含 视图 和 单元 格 的 树 形 滚动 视图 

好 了 吗 ? 

表 视 图 在 Cocoa 中 已 经 有 了 好 几 个 世纪 的 历史 。 有 差异 的 子 视图 意味 着 你 可 以 通过 忽略 一 些 行为 而 选择 另外 一 些 行为 ， 比 
如 ， 通 过 在 滩 动 视图 中 移 除 实 际 的 NSTableView 来 得 到 一 个 静态 表 视 图 。 之 前 这 种 做 法 可 能 是 正确 的 ， 但 现在 不 是 了 。 你 看 到 
的 每 件 事 都 是 强制 性 的 ， 如 果 不 想 使 用 一 个 特性 ， 那 惑 必须 要 天 闭 它 ， 而 不 是 删除 。 

过 去 这 样 做 很 糟糕 : 表 视 图 基于 单元 格 ， 它 是 继承 于 NSCell 的 子 类 。 它 们 都 不 是 视图 ; 将 它们 想象 为 子 程序 : 告诉 一 个 单 
元 格 在 屏幕 的 某 个 位 置 绘制 自身 ， 然 后 单元 格 就 会 执行 这 个 操作 。 如 果 你 想 要 表示 相同 的 事 (可 能 市 有 不 同 的 数据 ) ， 使 用 相同 
的 单元 格 并 告诉 它 在 这 里 绘制 。NSTableViews 通 单 每 列 只 有 一 个 NSCell， 重 复 使 用 它 来 绘制 每 一 列 。 单 元 格 与 钢 图 相 比 并 不 是 
资源 密集 型 (resource-intensive) 。 绝 大 多 数 AppKit 的 控制 视图 ， 比 如 文本 域 和 按钮 ， 都 依赖 于 NSCells 来 绘制 它们 的 内 容 ， 
并 对 事件 做 出 反应 。 

对 于 将 大 量 结构 化 的 元 素 放 在 比 现 代 计算 机 慢 100 借 ， 且 内 人 存 为 现代 计算 机 1% 的 机 器 屏幕 上 来 襄 这 不 是 一 个 明智 的 做 法 。 

在 21 世 纪 ， 我 们 可 以 使 用 视图 。 从 OS X 10.7 (Lion) 开始 ，NSTableView 提 供 了 基于 视图 的 模式 。 


开始 时 我 们 的 步伐 慢 一 点 ， 用 单个 表 显 示 团 队 名 称 、 得 到 的 分 数 以 及 丢失 的 分 数 。 选 中 表 视 图 ， 视 图 枝 的 深 处 很 难 操作 ， 不 
过 我 们 可 以 用 文档 大 纲 和 shift-control-click 弹 出 窗口 的 方式 操作 ， 见 图 20.2。 在 Attributes inspector 中 ， 将 表 设 置 为 3 列 。 


选择 你 喜欢 的 方式 ， 在 滚动 视图 的 下 一 层 选中 表 。 


Attributes inspector 为 你 提供 了 3 种 级 别 的 设置 ，NSTableView 中 的 每 一 级 都 在 类 的 层级 结构 中 : 首先 作为 表 视 图 ， 然 后 
作为 控制 视图 ， 最 后 仅仅 作为 一 个 视图 。 将 以 下 修改 作用 于 Table View 部 分 。 


- 确定 Content Mode Æ View Based. 


























O 市 








Table View Cell! ||Table Viey--"27-"'-**-- 
i League View Controller 
LeagueViewController 





View 
Bm NSView 





Bordered Scroll View - Table View 
Bm NSscrollView 





Clip View 
E NSClipView 





| Table View 


mi-i NS Tableview 


q Table Column 
qo NS lableColumn 


Table Cell View 


NSTableCellView 





a Table View Cell 
y NS TextField 





Table View Cell 
NS TextFieldCell 


图 20.2 ”在 Intetface Builder 视 图 上 执行 Shift-control-clicking 操 作 就 会 弹出 一 个 窗口 ， 能 让 你 选择 点 击 区 域 中 涉及 的 所 有 视图 。 男 外 
一 种 方法 是 在 文档 大 纲 中 选中 你 想 要 的 视图 ， 或 者 从 跳 转 栏 中 找到 它 ; 点 击 和 鼠标 直到 找到 想 要 的 视图 


将 Columns 设 置 为 3。 


` TAERAA Headers, Resizing ( 拖 动 headet 的 边缘 可 以 调整 宽度 ) FeRecording (在 界面 上 左右 移动 列 ) Haeo JAE 
ANT 6 


. Column Sizing 选 项 设置 为 Sequential。 这 样 当 重新 调 大 表格 宽度 的 时 候 ， 第 一 列 将 会 变 得 更 宽 ， 直 到 你 设置 的 极限 值 ， 然 
后 第 二 列 开始 变 宽 达 到 最 大 值 ， 之 后 是 第 三 列 。 


所 有 的 内 容 都 可 以 保持 之 前 的 样子 。 


所 以 你 可 以 设置 3 列 一 一 第 三 列 在 哪里 ? 当 你 重新 调整 表格 大 小 填充 窗口 的 时 候 ， 第 二 列 (和 最 后 一 列 ) 将 会 重新 调整 大 小 


填充 可 用 的 控件 。 第 三 列 被 添加 到 最 右边 ， 视 野 之 外 。 选 中 第 二 列 : 图 形 化 的 把 手 将 会 出 现在 每 一 条 边 ， 你 可 以 拖 动 这 些 边 来 缩 
小 列 的 锅 度 ， 直 到 能 够 看 到 第 三 列 。 


但 是 你 不 应 该 仪 任 肉眼 完成 这 个 工作 。 依 次 选中 每 一 列 ， 然 后 使 用 Size inspector 设 置 初 值 、 最 小 值 和 最 大 宽度 。 与 
Interface Builder 中 的 其 他 设置 一 样 ， 你 可 以 选择 多 个 视图 (比如 total-score 列 ) ， 然 后 一 次 性 设置 它们 的 宽度 和 限制 值 。 


当 你 选中 列 的 时 候 ， 你 会 看 到 Attributes inspector 将 会 提供 一 个 Title 栏 。 将 这 些 列 命名 为 Team Name、Own 和 Opp。 


w+ 我 将 Team Name 列 的 宽度 设置 为 240， 范 围 为 64~400， 分 数列 为 64:…64http://www.hzcoutrse.com/resource/readBook? 


path=/openresources/teach_ebook/uncomptressed/15555/OEBPS/Text/...120。 


让 我 们 看 看 它 现 在 是 如 何 工作 的 。Simulate Document 命 令 很 久 束 已 经 不 网 了 一 一 它 是 由 storyboard 中 独立 的 视图 控制 器 
组 成 的 窗口 的 转换 ， 用 它 来 模仿 布局 的 总 量 由 此 运行 整个 应 用 程序 。 所 以 ， 运 行 整个 应 用 程序 : Product 一 Run (HR) 。 将 会 
出 现 一 个 带 有 表格 的 文档 窗口 出 现 (图 20.3 上 ) 。 你 可 以 拖 动 列 的 边缘 重新 调整 它们 的 大 小 ， 或 者 在 它们 的 中 间 位 置 拖 动 它 由 此 
达到 重新 排列 的 目的 。 如 果 重 新 调整 列 的 大 小 会 让 表格 的 宽度 大 于 窗口 的 宽度 ， 那 么 可 以 滑动 。 这 就 是 它 的 工作 过 程 。 


重新 调整 窗口 的 大 小 (图 20.3 下 ) 。 布 局 问题 看 起 来 一 直 伴随 在 你 使 用 Cocoa 的 过 程 中 。 


= A League doc 


"y as NSWindow 


s A League doc 


wn 





图 20.3 (E) 新 表格 看 起 来 很 不 错 ， 直 到 (下) 你 重新 调整 窗口 大 小 ， 表 格 无 法 填 满 整个 窗口 。 这 是 另外 一 个 布局 问题 


之 前 我 们 使 用 过 Auto Layout; 在 AppKit 中 使 用 Auto Layout 与 在 UIKit 中 使 用 Auto Layout 并 无 二 异 。 现 在 你 甚至 都 不 用 思 
考 : 选中 Bordered Scroll View， 它 是 表格 最 外 层 的 容器 ， 然 后 使 用 h 将 表格 的 边 贴 合 容器 视图 的 边界 。 再 次 运行 Mac 
Passer Rating， 窗 口 大 小 惑 会 自动 调整 。 深 呼吸 ， 提 人 交 所 做 的 修改 。 


20.3” 填 爷 表 -一 一 绑 定 


League 表 已 经 准备 融 绪 ，AppKit 为 它 提 供 了 一 些 非 钊 实用 的 功能 ， 但 是 却 没有 为 实际 显示 做 任何 工作 。N3sTableView 闵 持 
委托 和 数据 源 方法 ， 与 UITableView 中 的 方法 很 像 ， 并 且 对 于 像 这 样 的 应 用 程序 ， 我 们 应 该 首先 米 用 这 些 方法 。 


但 是 ， 本 书 在 阐述 Xcode 特性 的 过 程 中 却 没有 坚持 这 点 ， 现 在 还 不 是 时 候 。 我 们 要 使 用 binding， 它 是 Key-Value 
Coding (KVC) 、Key-Value Observing (KVO) 以 及 NSController 子 类 的 集合 ， 它 将 会 自动 记录 模型 和 视图 中 的 更 改 ， 并 在 
两 者 之 间 传 递 相 应 的 更 改 。 


20.3.1 ”对象 控 制 器 


现在 还 要 继续 修改 Main.storyboard， 集 中 精力 于 LeagueViewController。 在 Object library 的 搜索 栏 中 输入 array， 库 列 
表 中 就 剩 下 了 一 项 Array Controller， 它 是 NSArrayController 的 实例 ， 它 也 是 提供 了 自动 访问 对 象 组 的 一 种 NSController。 将 
这 个 图 标 拖 到 视图 控制 器 场景 中 ， 这 个 控制 器 不 会 在 视图 中 显示 ， 但 是 它 会 显示 在 场景 项 部 的 工具 栏 中 ， 也 会 是 文档 大 纲 中 场景 


的 一 员 。 


SER Ai Interface Builder 中 看 到 的 图 标 只 不 过 是 占 位 符 。First Responder 和 File”s Owner 在 场景 或 者 XIB 中 并 非 实际 存 
在 ; 它们 仅仅 表示 那些 会 在 运行 时 解析 的 外 部 对 象 。NSAtrrayControllet 图 标 不 是 一 个 占 位 符 它 不 是 一 个 存在 于 NIB 文 档 中 的 
对 象 ， 当 NIB (XIB 或 者 场景 编译 后 的 产品 ) 载 入 的 时 候 ， 就 会 重新 组 建 它们 。 





确保 选中 了 array 控 制 器 ， 然 后 使 用 Attributes inspector 将 Mode 设 置 为 Entity Name， 然 后 将 Entity Name 栏 设置 为 
Team。 不 要 勾 选 任何 条 目 ; 你 仅 需 检查 teams， 所 以 它们 应 该 无 法 修改 ; 内 存 和 速度 都 不 是 问题 ， 所 以 Uses Lazy Fetching 没 
有 多 大 用 。 


同时 ， 确 保 没 有 勾 选 Prepares Content。 如 果 一 个 NSController 对 象 被 告知 要 准备 内 容 ， 但 此 时 它 还 没有 准备 好 要 创建 的 
对 象 的 实例 ， 那 么 它 就 会 创建 一 个 。 通 常 这 种 做 法 是 你 期 待 的 : 如 果 你 正在 编辑 一 些 内 容 ， 你 可 能 想 要 编辑 器 在 一 开始 就 准备 好 
做 一 些 事 。 


在 这 个 例子 中 ， 你 受 载 入 过 程 的 影响 : 一 个 管理 Core Data 对 象 的 对 象 控制 器 需要 一 个 托管 的 对 象 上 下 文 。 如 果 你 仔细 查看 
本 章 前 面 Loading the Window 中 的 makeWindowControllers()， 那 么 你 会 发 现 LeagueWindowController 和 它 的 视图 控制 器 
甚至 在 文档 的 Core Data 上 下 文 初始 化 之 前 都 无 法 看 到 。 当 你 让 对 象 控制 器 准备 Core Data 内 容 ， 而 它 没有 准备 对 应 的 托管 对 象 
内 容 的 时 候 ， 束 会 抛 出 异 弟 。 如 果 Prepares Content 没 有 勾 选 ， 那 么 在 你 允许 之 前 数组 控制 器 无 法 接触 到 Core Data. 


切换 到 Identity 查看 器 ， 并 将 Document 部 分 的 Label 设 置 为 Team Array， 完 成 数组 控制 器 的 设置 。 这 是 4 个 对 象 控制 器 中 
的 第 一 个 ， 之 后 你 会 在 列表 和 弹出 窗口 中 将 它们 区 分 开 。 


RE Team Array 数 组 控制 器 属于 LeagueViewController; 通过 打开 Asistant 编 辑 器 ， 显 示 出 
LeagueViewController.swift， 将 每 一 个 都 拖 到 class 的 定义 中 创建 对 应 的 outlets， 由 此 绑 定 到 LeagueViewController。 


@IBOutlet var teamArrayController: NSArrayController! 
@TBOutlet weak var tableView: NSTableView! 


现在 我 们 开始 绑 定 。 绑 定 依赖 于 KVO 协 议 。 任 何 对 象 都 可 以 要 求 另 外 一 个 对 象 的 指定 属性 友 生 更 改 的 时 候 得 到 通知 。 这 里 
有 很 多 细节 ， 条 件 和 警告 一 一 在 Documentation 浏 览 器 中 查找 KVO 一 一 但 是 这 样 做 的 缺点 就 是 对 象 的 属性 以 及 Core Data 对 象 


的 属性 都 要 因为 更 改 而 保存 。 


NSController 和 它 的 特例 (比如 NSArrayController) 使 用 KVO 将 对 象 的 值 和 用 户 界 面 元 素 的 链接 在 一 起 。 链 接 是 双 疝 的 
个 模型 对 象 的 值 会 在 上 友 生 更 改 的 时 候 通知 界面 ， 编 辑 界 面 上 的 值 也 会 目 动 更 新 异型。 这 些 链接 称 为 bindings ( 绑 定 ) 
(这 种 解释 很 简单 ， 但 是 足够 让 你 明白 Interface Builder 对 它们 的 支持 ) 。 





现在 已 经 构建 了 Team Array 控 制 器 ， 所 以 它 可 以 保存 Team 实 体 的 对 象 。 应 该 在 哪里 找到 这 些 对 象 ? 在 当前 文档 托管 对 象 
的 上 下 文中 (NSManagedObjectContext) 可 以 找到 。 文 档 和 数组 控制 器 分 别处 于 链 的 两 端 。 


- LeagueDocument， 作 为 基于 Cote Data 的 NSPersistentDocument， 它 有 NSManaped ObjectContext 管 理 文 档 的 存储 。 


` 在 这 个 链 中 ， 文 档 只 能 看 见 它 的 邻居 LeageueWindowController。 它 会 将 上 下 文 向 下 传递 到 窗口 控制 器 的 
managedObjectContext 属 性 。 


窗口 控制 器 知道 从 stotyboatd 中 载 入 的 LeagueViewConttollet; 视图 控制 器 有 一 个 managedObjectContext 属 性 用 于 窗口 控制 器 
的 填充 。 


- 视图 控制 器 从 带 有 Team Array NSAttayConttollet 的 stotyboatd 中 得 来 ， 它 需要 对 象 上 下 文 检索 数据 。 它 设置 了 数组 控制 器 的 


managedObjectContext 属 性 。 


- Team Atray 控 制 器 是 独一无二 的 。 看 看 本 章 的 过 程 : 数据 控制 器 是 文档 Core Data 内 容 的 唯一 直接 用 户 。Cocoa 通 过 创建 上 下 
文 来 初始 化 文档 对 象 ， 但 是 就 Mac Passer Rating 所 关心 的 内 容 而 言 ， 数组 控制 器 以 外 ， 其 他 角色 不 过 是 这 个 消费 者 的 监 寺 
KA. 


当 视 图 控制 器 收 到 managedObjectContext 之 后 ， 融 达到 了 最 后 一 步 。 它 可 以 触 点 搁 取 Team 伦 名 册 的 操作 。 


var managedObjectContext: NSManagedObjectContext! { 
didSet { 
// Pass the MOC to the array controller. 
teamArrayController.managedObjectContext = managedObjectContext 
// Ask the array controller for alphabetical order. 
teamArrayController.sortDescriptors = [ 
NSSortDescriptor( key: "teamName", 
ascending: true) ] 
// Have the team controller ask for the team roster. 
teamArrayController.fetchWithRequest (nil, 
merge: false 
error: nil) 


20.3.2 ”将 表 绑 定 到 Team 


表 中 的 每 一 行 代表 Team 类 的 一 个 实例 。 在 基于 视图 的 表 中 ， 表 在 行 间 分 配 实例 ， 而 且 还 是 要 知道 如 何 获 得 它们 。 除 了 
NSArrayController， 我 们 还 要 构建 视图 控制 器 或 者 一 些 其 他 的 对 象 ， 来 实现 NSTableViewDelegate 和 和 
NSViewTableViewDataSource， 就 像 之 前 我 们 在 iOS 的 UITableView 的 处 理 方法 一 样 。 表 将 会 询问 记录 的 数字 ， 然 后 按 需 拉 取 
它们 。 


NSObjectController 和 它 的 子 类 会 处 理 好 这 些 问 题 ， 代 价 是 陡峭 的 学 习 曲 线 。 它 们 两 个 会 通过 绑 定 链接 。 选 中 表 视 图 并 选 
择 Bindings 查 看 器 (第 四 个 选项 卡 ) ， 查 看 器 中 将 会 显示 很 多 属性 ， 这 些 属性 可 以 链接 到 表 中 。 其 中 我 们 想 要 使 用 的 属性 是 
Content， 在 Table Content 部 分 


单 击 提示 三 角 。 你 将 会 看 到 一 个 基本 的 绑 定 编辑 器 ， 用 于 其 他 绑 定 的 编辑 器 基于 这 些 元 素 构 建 。 
- Bind to 复 选 框 决 定 了 一 个 绑 定 是 否 处 于 激活 状态 。 勾 选 它 。 


. 它 旁 边 的 弹出 窗口 为 你 提供 了 绑 定 选择 。 它 包含 File s Owner, Shared User Defaults Controller (所 以 你 就 能 直接 控制 偏 


好 ) ， 以 及 场景 中 的 任意 NSControllet。 我 们 称 NSArrayControllet 为 Team Array， 它 用 于 管理 Team 对 象 ， 所 以 选择 Team Array. 


数组 控制 器 会 处 理 好 它们 保存 的 对 象 的 选择 和 排序 工作 ， 结 果 可 以 通过 它们 的 arrangedObjects 属 性 获得 。 访 问 它们 的 


Controller Key arrangedObjects, Interface Buildet 应 该 会 帮 你 填充 。 


当 表 的 单元 格 需 要 每 个 Team 的 特定 属性 时 ， 比 如 名 称 和 统计 数据 ，Model Key Path 会 变 得 很 重要 。 这 种 绑 定 适用 于 整个 数 


组 ， 所 以 将 它 留 空 。 


- Value Ttansfotmet 用 于 用 户 界 面 绑 定 。 值 的 转化 就 像 适 配器 ， 它 能 用 于 一 种 形式 的 数据 (属性 是 否 为 nil) 与 另外 一 种 形式 
的 数据 (按钮 是 否 处 于 启动 状态 ) 之 间 的 适 配 。 它 用 于 在 模型 对 象 中 创建 额外 的 属性 ， 用 来 适应 额外 的 视图 。 你 想 要 对 象 保持 原 


状 ， 所 以 这 一 栏 也 留 空 。 


- 4) %#Raises For Not Applicable Keys。 如 果 匀 选 了 这 一 项 ， 你 要 绑 定 的 属性 (model key 路 径 ) 就 无 法 通过 Key-Value Coding 的 
形 式 访问 ， AppKit 将 会 会 在 运行 时 抛 出 异常 。 可 以 想象， 你 不 想 让 条 件 通 过 ， 但 是 通常 会 会 引起 错误 ， 当 它 发 生 的 时 候 你 会 想 停 止 


pa 


已。 


20.3.3 ”将 询 绑 定 到 Team 属 性 


现在 表 已 经 知道 了 它 要 展示 的 记录 一 一 从 应 用 程序 Model 层 获得 的 对 象 一 一 但 是 还 不 知道 展示 什么 内 容 。 如 果 运 行 Mac 
Passer Rating， 选 择 行 的 时 候 里 面 什 么 也 没有 。 行 中 的 每 一 个 单元 格 应 该 知道 显示 什么 内 容 。 


单元 格 的 层次 结构 比 你 想象 的 深 许多 ， 它 们 并 不 是 单一 的 UITableView 视 图 。 再 次 查看 图 20.1。 
一 行 都 有 一 个 NSTableViewCell (或 者 子 类 ) 视图 ， 一 个 挨 一 个 。 

: 每 一 个 单元 格 视图 都 是 可 展示 、 可 单 击 并 且 可 编辑 的 控制 视图 的 根 视图 。 

“ 在 AppKit 中 ， 控 件 通 第 依赖 NSCell 子 类 运行 。 

- 单元 格 可 能 有 修改 行为 的 附件 。 


NSsTableView 通 过 单元 格 的 objectValue 属 性 ， 指 定 了 行 所 在 对 象 的 引用 表示 每 一 个 NSTableViewCell。 它 取决 于 单元 格 和 
将 它们 的 内 容 链接 到 模型 对 象 内 容 上 的 子 视 图 。 

开始 ， 我 们 使 用 文档 大 纲 选 中 League View Controller 一 View 一 Bordered Scroll View 一 Clip 
View 一 TableView 一 Name ( 列 ) 一 Table Cell View (NSTableViewCell) 一 Table View Cell ( 带 有 默认 文本 的 
NSTextField) 。 


一 次 我 们 使 用 Bindings 坦 看 器 在 Value 部 分 设置 Value 绑 定 。 这 个 编辑 器 更 加 复杂 。 将 值 绑 定 到 Table Cell View (命名 、 
人 名 、NSTableViewCell) ， 同 时 使 用 objectValue.ownTotalScore (objectValue 是 Team 对 象 ，ownTotalscore 是 我 们 想 要 


展示 的 对 象 属性 ) 的 关键 路 径 。 


Allows Editing Multiple Values Selection: 如 果 设 置 了 这 个 选项 ， 那 么 用 户 可 以 选择 多 个 对 象 (比如 当 我 们 在 第 9 章 中 一 次 性 


选中 Game 所 有 的 数字 属性 ) ， 编 辑 这 个 控件 会 在 所 有 选择 的 对 象 中 设置 给 定 的 属性 。Team 名 称 不 可 编辑 ， 在 一 个 选中 的 行 中 编 
辑 多 个 部 分 没有 意义 ， 所 以 我 们 不 匀 选 这 一 项 。 


- Always Presents Application Model Alerts: 如 果 一 个 控件 没有 正常 运行 ， 那 么 常见 的 做 法 是 在 错误 发 生 的 窗口 中 显示 一 个 警 


告 框 。 
- Conditionally Sets Editable. Enable # Hidden: 你 在 Attributes 查 看 器 中 为 文本 栏 设置 了 这 么 多 属性 (文本 栏 无 法 修改 就 变 
成 了 标签 ) ,但 是 如 果 文 本 栏 有 限制 ， 你 就 可 以 挨个 重 写 可 能 你 想 要 将 内 容 置 灰 ， 但 是 只 有 特定 的 记录 才 会 这 样 。 在 你 





不 需要 它们 之 前 不 要 设置 它们 。Conditionally Sets Editable 可 能 会 寻 致 一 些 问题 ， 如 果 不 是 般 肖 ， 如 果 Cocoa 目 己 允 许 用 户 编辑 那 
些 不 应 该 更 改 的 值 。 


- Continuously Update Value: 通常 模型 不 想 获 得 新 值 ， 直 到 用 户 进 入 后 。 当 前 正在 处 理 的 值 可 能 会 触发 高 昂 的 操作 或 者 验证 
警告 。 这 里 有 一 些 想 要 获得 正在 处 理 的 内 容 的 原因 。 


ww 


+ 模型 或 者 你 自 定 义 的 NSObjectConttolleft， 当 这 个 值 还 没 处 理 完 成 的 时 候 ， 应 该 评估 正在 处 理 影 响 到 编辑 〈 比 如 ) 的 值 ， 
在 上 面 显示 一 个 红色 的 标记 。 


:你 可 能 在 很 多 Mac 应 用 程序 中 注意 到 了 这 一 点 : 如 果 编 辑 一 个 文本 栏 ， 那 么 当 你 按 下 tab 键 或 者 teturn 键 的 时 候 就 会 完 
编辑 。 如 果 值 没有 持续 更 新 ， 这 种 情况 就 会 发 生 在 当 它 向 控制 器 或 者 模型 报告 的 时 候 。 如 果 你 单 击 其 他 位 置 而 不 是 按 下 一 个 “ 完 
成 ”按键 ， 那 么 新 值 并 不 会 生效 。 如 果 值 在 持续 更 新 ， 那 么 控制 器 和 模型 就 能 获得 最 后 的 值 而 不 用 管 编辑 操作 如 何 停止 。 


. 我 们 不 想 编辑 team 名 称 ， 所 以 不 匀 选 这 个 选项 。 


- Raises For Not Applicable Keys: 在 表 内 容 绑 定 中 我 们 已 经 看 到 了 这 一 点 ， 如 果 你 命名 的 属性 不 存在 ， 那 么 就 会 出 现 前 溃 。 
匀 选 这 个 选项 。 


Validates Immediately: 当 你 移动 到 另外 一 个 控件 的 时 候 ， 是 否 应 该 立即 检查 单元 格 的 内 容 ， 或 者 是 否 应 该 等 待 整个 记录 是 
否 完 成 ? 我 们 不 更 改 team 的 名 称 ， 所 以 跳 过 这 一 步 。 


- Multiple Values Placeholder: 如 果 你 的 确 选 中 了 多 个 对 象 ， 但 是 相关 的 属性 在 它们 之 间 并 不 相同 ， 它 就 是 在 用 户 没 有 提供 正 


第 值 之 前 应 该 显示 的 内 容 。 它 是 一 个 占 位 符 ， 它 不 会 进入 模型 之 中 。 


- No Selection Placeholder: 当 NSArrayControllet 没 有 选择 的 时 候 ， 显 示 什 么 内 容 。 比 如 ， 描 述 选 中 对 象 的 标签 ( “3 teams 


selected” ) 应 该 替换 为 “SelectaTeam ”。 


- Not Applicable Placeholder: 你 的 NSObjectConttollet 子 类 可 能 会 将 一 个 属性 的 值 描述 为 “不 适用 (not applicable) ” 如 果 
Team 有 一 个 属性 用 来 表示 它 拥 有 的 人 造 草坪 ， 团 队 在 这 块 草坪 上 比赛 ,那么 这 个 属性 应 该 不 适用 。 


- Null Placeholder: 让 属性 成 为 不 适用 或 者 未 分 类 的 另外 一 种 方法 是 将 它 置 为 mill， 控件 上 通 显示 为 “(null) ” 


对 ownTotalScore 和 和 oppTotalScore 做 相同 的 操作 。 它 们 都 是 数字 。 绑 定 机 制 不 关心 它们 是 什么 ，NSTextField 会 用 合理 的 
格式 显示 它们 ， 所 以 不 需要 担心 。 使 用 Attributes 查 看 器 将 文本 栏 视图 设置 为 靠 右 对 齐 会 是 一 个 非常 好 的 操作 。 


一 切 都 还 不 错 ，team 表 应 该 联系 在 一 起 。 运 行 Mac Passer Rating。 如 果 之 前 en ae 那么 就 创建 一 个 (中 
N) ， 并 使 用 实例 数据 填充 (ÆT) 。 这 一 次 ， 一 切 顺 利 。 文 档 窗口 显示 了 队伍 名 称 和 总 分 ， 见 图 20.4。 


Untitled 2 

Name 

Augusta Autocrats 

Boise Bearcats 

Des Moines Desperadoes 

Fremont Firebugs 

Glendale Centers 

Grand Rapids Gamers 

Huntington Beach Harriers 

Mobile Misfits 

Modesto Misanthropes 


Montgomery Music 
Richmond Roustabouts 
San Bernardino Stalkers 
shreveport Seamen 





图 20.4 第 一 个 版 本 的 Mac Passer Rating 显 示 了 按照 总 分 排序 的 团队 名 称 。NSAttayConttollet 完 成 这 一 切 基本 上 没有 什么 代码 ， 虽 
然 在 这 个 简单 的 应 用 程序 中 也 花费 了 不 少 力气 。 应 用 程序 中 涉及 的 内 容 越 琐碎 ， 使 用 绑 定 就 能 节约 越 多 的 工作 


20.4 League 文档 数据 的 结构 


现在 ， 离 我 们 在 第 19 章 图 19.1 中 设 定 的 目标 仅 有 一 小 段 距离 。Team 表 应 该 简化 为 一 个 列表 ， 显 示 选 中 的 团队 和 它 的 


passer。 


20.4.1 从 League 表 到 Source List 


首先 要 做 的 瓯 是 移 除 League 表 中 的 最 后 两 齐 。 这 瓯 是 更 改 的 代价 。 选 中 Own 和 Opp 列 ， 并 按 下 delete 键 。 选 中 表 视 图 并 通 
过 在 Attributes 查 看 器 中 取消 勾 选 Header 复 选 框 移 除 header (不 要 兰 试 删除 header 视 图 ， 记 住 ，NSTableView 需 要 它 的 原型 视 
图 结构 ) 。 将 Highlight 更 改 为 Source List， 这 样 惑 能 得 到 具有 Mac 风 格 的 背景 颜色 和 选中 状态 的 列表 。 


这 种 设计 成 为 split view (分 拆 视图 ) ， 列 表 在 左边 ， 详 情 内 容 在 右边 。 完 成 这 种 设计 方案 的 一 种 方法 是 添加 NSView 在 
LeagueViewController 场 景 的 右 侧 保存 细节 视图 ， 调 整 列 表 和 详细 视图 的 Auto Layout 约 束 ， 这 样 它们 就 可 以 挨 着 并 且 填 充 整 
个 场景 。 选 中 它们 两 个 ， 然 后 选择 Editor 一 Embed in 一 Split View。 这 条 命令 会 插入 一 个 NSSplitView， 两 边 各 包含 一 个 视图 。 
还 需要 做 一 些 修改 ， 大 多 数 工 作 都 是 将 新 的 标 答 和 表 与 模型 链接 在 一 起 ， 无 论 是 额外 添加 NSControllers 还 是 直接 在 
LeagueViewController 上 操作 。 


还 有 一 种 方法 ， 我 们 会 使 用 窗口 自己 的 NSViewController 对 象 控 制 窗 口 每 一 个 功能 区 域 的 Yosemite 模 板 。 不 将 主 表 和 细节 
视图 放 到 分 拆 视图 ， 而 是 将 所 有 的 内 容 都 在 LeagueViewController 的 控制 之 下 ， 我 们 将 会 添加 一 个 NSSplitViewController， 让 
这 两 个 视图 作为 它 的 内 容 。 


注意 它们 两 个 的 区 别 : LeagueViewController 不 再 是 窗口 中 唯一 的 控制 器 ， 它 的 场景 也 不 再 构成 窗口 的 全 部 内 容 ， 现 在 完 


整 的 窗口 角色 属于 由 AppKit 提 供 的 NSSplit ViewController。LeagueViewController 将 仪 仅 控 制 两 个 视图 中 的 一 个 ， 另 外 一 个 
由 我 们 称 为 TeamDetailController 的 对 象 管理 。 


进入 Object 库 (Utility 区 域 的 底部 ， 第 三 个 选项 卡 ) ， 搜 索 split， 就 会 看 到 Vertical Split View Controller。 将 它 拖 入 画布 
中 (确保 选中 的 是 控制 器 ， 而 不 是 视图 ) 。 控 制 器 场景 包含 两 询 的 分 拆 视图 ， 并 且 市 有 两 个 视图 控制 器 场景 。 
NSsspliteViewController 基 本 上 不 需要 修改 什么 ， 它 仅 用 来 布局 和 记录 。 


© jt ”事实 上 ，NSSplitViewController 没 有 这 么 简单 ; 它 帮 你 处 理 了 很 多 繁琐 和 重复 的 工作 ， 同 时 可 以 访问 AppKit 的 内 
部 ， 比 如 ， 如 果 分 拆 视图 中 的 一 部 分 隐藏 的 时 候 ， 就 不 会 载 入 它 的 子 控制 器 。 


删除 带 有 分 拆 控制 器 的 场景 ; 它们 没有 那么 神奇 ， 如 果 已 经 有 了 一 个 控制 器 ， 那 么 我 们 无 法 再 放 入 一 个 控制 器 。 在 分 拆 控制 
器 向 LeagueViewController 执 行 control-drag 操 作 ， 这 样 它 就 是 第 一 个 控制 器 ， 元 素 都 在 分 拆 视图 中 。 


接 下 来 ， 将 NSViewController 拖 到 画布 中 ， 然 后 在 分 拆 视图 场景 中 control-drag 一 个 连接 到 它 上 面 。 分 拆 视图 中 的 主 视图 
和 细节 视图 中 间 有 一 个 双方 向 的 分 拆 线 。 将 新 的 视图 控制 器 变 为 你 自己 的 ， 在 Identity 查看 器 中 ， 将 类 命名 为 


TeamDetailController, 


Xcode 会 抱怨 说 没有 像 TeamDetailController 这 样 的 类 ， 所 以 让 我 们 新 建 一 个 : 
File>New—Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/... (ÆN) 创建 一 个 新 的 Swift 类 
TeamDetailController， 它 作为 NSViewController 的 子 类 。 这 样 就 可 以 在 一 段 时 间 内 摆脱 Xcode 的 抱怨 。 


使 用 control-drag 的 操作 让 窗口 场景 标题 栏 的 LeagueWindowController 的 图 标 向 下 拖 到 分 拆 视图 控制 器 上 面 ， 让 分 拆 视 
图 作为 窗口 的 内 容 视 图 。 这 两 个 视图 之 间 的 线 以 及 NSSplitViewController 与 两 个 视图 控制 器 之 间 的 线 称 为 relationship， 而 不 
是 segues。 不 存在 的 控制 器 将 会 得 到 一 个 prepareForSegue( ,sender:) 的 调用 来 初始 化 接 下 来 的 场景 。 


实际 上 这 不 算是 一 个 问题 ， 因 为 NSSplitViewController 保 仔 了 它 的 NSSplitView Items 的 列表 ， 它 保存 痢 各 目的 视图 控制 
器 。 作 为 一 个 NSWindowController，LeagueWindow Controller 有 一 个 contentViewController 属 性 指向 分 拆 视图 控制 器 。 
文档 之 间 有 一 条 无 颖 的 路 径 ， 穿 过 分 拆 通 向 窗口 ， 穿 过 分 拆 视图 ， 向 下 指向 视图 控制 器 。 


在 20.2 节 中 看 到 ， 连 接 分 拆 视图 的 代码 已 经 在 windowDidLoad 中 ， 但 是 使 用 usingSplitView 标 识 隔离 。 将 它 设置 为 true 局 
动 完整 的 处 理 (示例 代码 显示 了 window DidLoad 完 成 处 理 的 版 本 ) 。 


将 usingSplitView 改 为 true， 然 后 注释 掉 声 明 teamDetailController 的 那 一 行 。 翻 回 到 20.2 节 ， 重 新 查看 windowDidLoad 
工作 方式 是 一 个 不 错 的 做 法 。 


20.4.2 ”捕获 Team 的 选择 


想象 你 使 用 文档 窗口 的 场景 : 在 列表 中 (分 拆 视图 左 侧 的 LeagueViewController) 选择 一 个 队伍 ， 细 节 视 图 
(TeamDetailController 这 一 半 ) 就 会 显示 出 团队 信息 。 选 择 的 时 候 产生 的 变化 ， 当 选中 对 象 的 时 候 ， 需 要 将 主 视图 中 的 内 容 
传递 到 详细 视图 中 ， 因 为 它们 两 个 在 不 同 的 场景 中 ， 所 以 无 法 直接 通信 。 窗 口 控制 器 会 直接 访问 它们 两 个 ， 所 以 可 以 作为 媒介 。 


在 图 20.5 中 可 以 看 到 完整 的 处 理 过 程 。 


League 
Window 






M.O. 
Context 





' Passers 


图 20.5 ”联盟 文档 窗口 的 内 容 后 面 有 一 条 线 从 Teams 表 到 Cote Data 存 储 的 文档 ， 穿 过 了 包含 Team、Passer 和 Game 的 序列 。 每 一 


都 要 通过 NSObjectControllet 或 者 NSArrayControlletr 作 为 媒介 
` 你 已 经 完成 了 第 一 部 分 : LeagueViewControllet 从 文档 的 Core Data 存 储 中 获取 Teams 数 据 ， 然 后 使 用 它 填充 表 。 
-可 能 你 已 经 单 击 了 团队 列表 中 的 某 些 行 ， 你 要 做 的 下 一 件 事 就 是 让 选中 的 团队 详细 信息 显示 在 窗口 另 一 半 的 细节 视图 中 。 
- 由 LeagueWindowController 接 收 LeagueViewControllet 发 出 的 event。 
事件 确认 了 用 户 选 中 的 Team， 窗 口 控制 器 会 将 Team 向 下 传递 给 TeamDetail Controller。 
… 还 有 一 些 问 题 后 面 骨 说。 


我 将 用 户 单 击 league-view 表 中 团队 的 操作 称 为 “事件 (event) ”。Cocoa 中 由 很 多 机 制 可 以 让 对 象 之 间 相 互通 信 
次 ， 我 打算 使 用 Key-Value Observing 的 方法 。 


Ore 当 任 何 对 象 想 要 获取 类 X 的 一 个 属性 的 时 候 ，Objective-C 运 行 时 库 (Swift 应 用 程序 中 也 有 ) 就 会 创建 一 个 新 的 叉子 
类 ， 它 有 自己 的 设置 观察 属性 的 函数 。 当 任何 代码 设置 了 观察 属性 ， 包 装 方法 首先 就 会 注意 到 原始 值 ， 通 过 义 中 “真正 的 ”设置 
隙 数 调用 ， 当 设置 完成 的 时 候 ， 就 会 触发 所 有 观察 这 个 属性 的 对 象 的 观察 方法 。 


了 解 这 一 点 有 助 于 你 更 好 地 理解 在 LeagueWindowController 的 windowDidLoad 方 法 中 的 addObserver 语 句 。 这 个 调用 会 
告诉 LeagueViewController 的 Team Array 控 制 器 .… 


leagueViewController.teamArrayController.addObserver ( 


注册 self，LeagueWindowController 自 身 : 


self, 


作为 selectedObjects 属 性 的 观察 者 。 


forKeyPath: "selectedObjects", 
没有 对 属性 更 改 前 后 值 的 任何 特殊 需求 ， 这 里 有 一 个 标识 值 能 让 你 更 简单 的 区 分 事件 来 临 ， 


options: NSKeyValueObservingOptions (0), 
context: &teamSelectionChange) 


LeagueWindowController 定 义 了 标准 的 observeValue 方 法 ， 它 捕获 了 所 有 属性 更 改 的 事件 。 


override func observeValueForKeyPath(keyPath: String, 
ofObject object: AnyObject, 
change: [NSObject : AnyObject], 
context: UnsafeMutablePointer<Void>) { 

if context == &teamSelectionChange { 
if let selection = object.valueForKeyPath("selectedObjects") 
as? [Team] { 
teamDetailController?.representedObject = 

(selection.count > 0) ? selection[0O] : nil 


} 


9 注意 ”这 是 一 个 override 济 数 ， 因 为 NSOBject 一 一 以 及 Cocoa 中 的 每 个 类 一 一 已 经 实现 了 它 ， 所 以 你 需要 添加 一 个 override 





属性 来 声明 函数 在 继承 关系 中 的 路 径 。Swift 有 很 多 这 样 的 修饰 符 ， 你 应 该 合理 使 用 提供 的 这 些 标签 。 完 成 继承 或 者 协议 函数 最 
简单 的 方法 就 是 输入 函数 的 名 称 一 一 仅仅 是 名 称 ， 不 包含 关键 字 一 一 触发 代码 补 全 。 如 果 Xcode 提 供 了 你 想 要 的 函数 签名 ， 那 么 
就 会 提供 所 有 的 修饰 符 。 


这 个 为 数 会 检查 context 人 参数， 核实 它 匹 配 我 们 传 入 的 任意 标识 ， 因 此 证 明 事 件 是 Team Array 控 制 器 所 选 对 象 的 更 疏 。 它 会 
将 selectedObjects 作 为 一 个 Team 对 象 的 数据 ([Team]) 。 


如 果 有 任何 选中 的 Teams (至 少 有 一 个 ) ， 消 数 将 会 取得 第 一 个 ， 然 后 将 它 传 入 Team DetailController 中 作为 
representedObject。 如 果 没 有 选中 Teams， 那 么 representedObject 将 会 被 设置 为 nil。 


这 样 就 完成 了 图 20.5 的 上 半 弧 。 
20.4.3 ”从 Team 到 表 


绑 定 基于 Key-Value Observing。 它 们 通过 链接 模型 和 视图 对 象 扩展 了 KVO， 对 象 之 间 可 以 观察 到 对 方 。 在 Bindings 查 看 
器 中 看 到 的 绑 定 编辑 器 会 在 查看 视图 中 的 属性 的 时 候 显示 ; 你 确定 了 对 象 和 那些 将 会 与 编辑 器 控制 的 视图 属性 交换 观察 者 的 属 
性 。 


StS ”你 可 以 在 代码 中 绑 定 任意 两 个 Cocoa 对 象 的 属性 ， 无 论 这 一 对 属性 是 模型 还 是 视图 。 有 少量 开发 者 很 乐于 这 样 做 : 
Interface Buildet 提 供 了 相互 绑 定 的 支持 ， 标 准 的 Cocoa 对 象 (无 论 是 否 相 信 ) 都 很 容易 处 理 ; 让 所 需 的 行为 保持 正确 ， 从 而 促使 
所 有 的 新 类 完成 合适 的 绑 定 有 些 困难 。 


TeamDetailController 视 图 由 两 个 表 组 成 ， 其 中 一 个 是 Passers， 另 外 一 个 是 Games。 之 前 你 曾经 集中 精力 于 表 中 ; 你 知道 
我 们 需要 两 个 NSArrayController， 其 中 一 个 用 于 Passers， 另 外 一 个 用 于 Games。 这 些 控制 器 需要 一 个 源 。 在 Teams 的 League 
表 中 ， 所 有 的 数据 源 来 自 文档 存储 的 所 有 Team 对 象 。 


一 旦 用 户 选 择 了 一 个 队伍 ，Team 对 象 就 会 找到 对 应 的 TeamDetailController， 它 也 不 在 意 对 象 是 Core Data 管 理 的 对 象 。 
细节 控制 器 不 需要 通过 数据 库 查 询 团队 中 的 passer， 它 有 team 的 数据 ， 能 直接 提供 passer 列 表 。 


这 将 导致 如 下 的 TeamDetailController 定 义 : 


class TeamDetailController: NSViewController 1{ 


var currentTeamName: String? { 
let team = representedObject as? Team 
return team?.teamName 


class func keyPathsForValuesAffectingCurrentTeamName () 
-> NSSet { 
// There is no setter method that KVO could use to trigger a 
// changed-value observation for currentTeamName. 
// currentTeamName is computed, never assigned; the 
// computed value changes only when representedValue changes. 


// keyPathsForValuesAffecting<PropertyName>() lets a class 
// say, “send out an observation whenever any of the properties 
// in this list change." 


// Changing representedObject would change the computed value 
// of currentTeamName, so return an NSSet containing 

// "“representedObject". 

return NSSet(array: ["representedObject"] ) 


@IBOutlet var gameArrayController: NSArrayController! 
@IBOutlet var passerArrayController: NSArrayController! 
@TBOutlet var teamObjectController: NSObjectController! 


override 
var representedObject: AnyObject? { 
didSet { 
teamObjectController.content = representedObject 


很 难 回 避 绑 定 ， 但 是 可 以 给 予 一 些 信 任 : TeamDetailController 由 4 个 任务 、 一 个 恒定 对 象 和 一 个 数据 访问 组 成 。 我 们 将 会 
有 一 个 由 标签 和 表格 组 成 的 系统 ， 它 会 反映 出 用 户 对 3 个 变量 的 选择 ， 每 一 个 都 过 滤 了 下 一 个 ， 包 括 字 符 串 格式 化 以 及 将 数据 导 
入 表 ， 这 一 切 都 在 19 行 格式 化 的 代码 中 。 


让 我 们 完成 在 “捕获 Team 选 择 ” 中 的 过 程 。 之 前 我 在 窗口 控制 器 将 选中 的 Team 对 象 传递 TeamDetailController 的 过 程 中 
停 了 下 来 。 





- TeamDetaiConttollet 维 护 了 一 个 NSObjectConttollet 用 来 “管理 ”将 要 在 视图 中 显示 的 Team。 原 则 上 ， 并 不 需要 这 样 HR 
定编 辑 器 提供 了 直接 将 一 个 视图 控制 器 的 一 个 属性 绑 定 到 它 本 身 的 功能 ; 实际 上 ， 如 果 你 为 NSConttoller 对 象 留 下 了 尽 可 能 多 的 
链 ， 那 么 更 改 通知 的 功能 会 做 得 很 好 。 当 设置 了 视图 控制 器 的 fepfesentedObject 属 性 后 ，TeamDetailConttollet 将 它 作 为 对 象 控 制 器 


的 cohteht 对 象 。 


- NSArtrayConttollet 为 上 层 表 提供 了 内 容 ， 上 层 表 里 面 存 放 的 是 Passefs。 表 通常 由 NSAttayConttollets 运 行 ; 它 为 Mode 


Class (不 是 Entity， 与 主 Core Data 存 储 没 有 关系 ) 和 Class Name Passet 而 设置 。 


20.4.4 “Passer 部 分 


Team Detail 的 上 半 部 分 视图 显示 了 Passers 与 所 选 的 Team 之 间 的 关系 。 它 是 一 个 标签 ， 由 Team Object 控制 器 管理 ， 还 有 
一 个 由 NSArrayController 控 制 的 表 ， 它 管理 了 一 个 Passer 对 象 的 列表 。 


Passer Array 控 制 器 


LeagueViewController 场 景 中 NSArrayController 最 大 的 区 别 就 在 于 它 管 理 的 对 象 是 Class (不 是 
Entity) Passer，Bindings 查 看 器 中 的 Content Array 的 数据 源 来 和 目 Team Object 的 selection 中 的 passers 数 组 。 即 使 Team 
Object 控制 器 是 一 个 只 选中 了 一 个 对 象 的 NS9Object Controller， 它 也 有 一 个 selection 属 性 ， 从 这 里 可 以 得 到 想 要 的 数据 。 


需要 准备 数据 ， 内 容 设 置 为 不 可 编辑 。 在 ldentity 查 看 其 中 ， 将 它 的 名 字 改 为 Passer Array。 还 有 另外 一 个 数组 控制 器 ， 
你 需要 将 它们 区 分 开 


rip penne 不 过 现在 还 没有 Game: Core Data schema 仅 仅 将 Team 链 接 到 了 Games; game 
列表 需要 通过 Passer 追 踪 到 对 应 的 Games。 


将 这 个 属性 添加 到 Team。 


var passers: [Passer] { 
// Team doesn't have a relationship to Passer, except 
// by way of .games. Have .games list the Passers 
// in all Games, with the duplicates filtered 
// out (a "distinct union" of Passers). 


let unionOfPassers = self.games.valueForKeyPath ( 
"@distinctUnionOfObjects.passer") 
as NSSet? 
if let passerSet = unionOfPassers { 
return passerSet.allObjects as! [Passer] 


} 


else { return [] } 


=I HR Æ F] Passer Array 7 h) B 4 Content Atray 应 该 使 用 (@distinctUnionOfObjects.passer， 但 是 让 我 们 在 代码 中 保持 这 个 


关系 ， 因 为 绑 定 参数 实在 太 难 调试 。 


Passer-Table 标 签 


将 一 个 标签 拖 到 场景 中 ， 人 允许 Interface Builder 使 标签 与 根 视 图 的 顶部 和 边界 保持 标准 的 距离 。 将 它 从 标准 根 视图 的 右边 界 
向 外 拖 动 ， 选 择 Editor 一 Resolve Auto Layout lssues 一 Add Missing Constraints, Team Detail 视 图 不 需要 任何 自 适 应 的 布 
局 ; 仪 需要 按 需 将 它们 放 在 你 想 要 放置 的 位 置 ， 然 后 允许 1B 添 加 约束 。 


+ 标签 的 内 容 应 该 和 所 选 的 Team 保 持 一 致 ， 也 就 是 说 要 绑 定 到 Team Object NSObjectController 上 。 这 个 标签 会 有 之 前 没 见 到 


过 的 两 个 绑 定 。 


标签 应 该 使 用 team 的 名 称 描述 passef 表 ， 比 如 Passets for the Birmingham Beatcats。 可 能 你 期 竺 代码 中 格式 化 文本 ， 但 是 Value 
With Pattetn 绑 定 能 够 在 UI 元 素 中 提供 简单 的 格式 化 文本 而 不 用 求助 于 代码 。 


- 打开 Value With Pattern—Display Pattern Value1 编 辑 器 ， 然 后 将 它 绑 定 到 Team Object，selection 和 teamName， 到 现在 为 止 ， 
一 切 都 如 你 所 料 。with 一 pattern 编 辑 器 添加 了 一 个 栏 位 Display Patterm。 这 个 栏 位 有 一 个 非常 简单 的 语义 : 写 下 文本 ， 添 加 一 个 占 
位 符 作 为 临界 值 ， 就 像 Passers for the%f{valueli(@。value 后 面 总 是 会 添加 一 个 数字 。 后 面 你 会 明白 为 什么 要 添加 一 个 数字 。 


| 编辑 器 包含 特例 占 位 符 。 下 一 步 介 绍 为 什么 我 们 不 需要 关心 它 是 什么 


. 我 们 也 要 设置 Hidden 绑 定 。 如 果 没 有 要 展示 的 Team 名 称 ， 就 无 法 填充 “Passets for the… ”这 一 句 ， 这 会 很 槛 炊 。 最 好 不 要 


显示 这 各 话 。 绑 定 是 Team Object、selection、self。 每 个 NSObject 都 有 一 个 self 属 性 。 它 会 返回 对 象 本 身 ， 相 当 方 便 ， 比 如 在 这 个 
子 中 ， 如 果 想 指定 一 个 属性 ， 首 先 要 获得 对 象 本 身 。 


下 一 栏 是 Value Transformer。 输 入 NSIsSNil， 自 动 完 成 功能 将 会 自动 补 全 。NSValue Transformer 的 类 将 会 把 一 种 类 型 与 
另外 一 种 类 型 链接 在 一 起 。 一 个 更 复杂 的 例子 是 如 果 一 个 对 象 有 一 个 RGB 的 color 属 性 ， 它 确定 了 名 字 的 颜色 ， 比 如 green 或 者 


magenta, 


当 selection 为 nil 的 时 候 ， 我 们 想 要 隐藏 这 个 标签 ， 因 为 没有 要 显示 的 Team。 这 是 一 个 关于 是 非 的 Boolean 问 题 ， 但 nil 并 不 
是 一 个 Boolean 值 。NSIsNII 会 接受 任何 指针 并 返回 这 个 指针 是 否 为 nil。 如 果 selection.self 为 nil， 那 么 转换 栏 将 为 true (在 
Objective-C 中 为 YES) ， 通 知 标签 应 该 隐藏 。 


Passer% 
是 另外 一 个 视图 ， 和 希望 内 容 是 Passers， 这 张 表 不 涉及 新 内 容 。 


在 Object 库 中 找到 Table View， 将 它 拖 到 视图 中 。View Based; 与 标签 乙 间 保持 标准 的 间距 ， 与 父 视图 的 边 保 持平 齐 ; 
Add Missing Constraints 来 锁定 它们 ;最 小 吏 度 是 400， 这 样 才能 保持 标签 的 可 读 状 态 并 能 约束 窗口 的 冤 度 ， 高 度 设置 为 120 


points, 


使 用 lIdentity 查 看 器 将 封闭 的 NSScrollView 的 Document Label 设 置 为 Passer roaster, MHA MAIAKS CAA BAO 
game 表 。 


headers 中 有 7 列 ， 标 签 分 别 为 Name、Rating、Att、Comp、Yards、TDs、1NTs。 
依次 选中 每 一 列 。Attributes 查 看 其 有 一 个 部 分 专门 用 于 列 的 默认 排序 。 对 于 数字 列 ， 将 排序 规则 设置 为 : 
- Sort Key， 它 是 PasserClass 属 性 名 ， 与 列 相对 应 。 


- Selector， 这 一 栏 的 默认 值 是 “compatre:”， 它 是 一 个 带 有 NSString 和 NSNumber 的 方法 ， 可 以 满足 你 的 需求 。 需 要 注意 它 是 


Objective-C， 所 以 要 包含 冒号 。 
- Order: Ascending， 初 始 化 。 单 击 列 标 题 将 会 在 升 友 和 降序 之 间 切 换 。 


将 Name 列 的 Sort Key 设 置 为 lastName， 所 以 我 们 做 一 个 简单 的 对 比 : 使 用 字符 串 。 在 一 个 好 的 App 中 ，Passer 的 比较 加 
数 应 该 按照 last Name、firstName 的 顺序 比较 ， 但 是 在 这 里 我 们 简化 一 下 。 


注意 ”现在 ，Interface Buildet 中 将 会 显示 黄色 的 警告 ， 提 示 TeamDetailConttollet 场 景 中 的 帧 数 不 正确 。 其 中 一 些 错误 是 引 
导 问 题 ， 所 以 你 需要 通过 约束 和 占 位 符 解 决 。 不 过 ， 在 我 使 用 的 Xcode 版 本 中 ， 有 一 些 关 于 表 视 图 的 警告 。 我 无 法 清除 这 些 警 
告 ， 不 过 它们 也 没什么 太 大 的 副作用 。 即 使 Xcode 无 法 正确 执行 Auto Layout 的 功能 。 与 任何 警告 一 样 ， 正 确 对 待 Auto Layout 的 警 


告 ， 但 是 如 果 你 做 了 很 大 的 努力 ， 还 是 没 能 清除 这 些 警告 ， 但 是 也 没 出 现 什么 大 问题 ， 那 么 就 随 它 去 吧 。 


这 些 都 是 默认 的 排序 ， 我 们 想 让 用 户 单 击 header 的 时 候 切 换 排 序 规则 。 表 会 使 用 Passer Array NSArrayController 类 型 的 
arrangeObjects 数 组 。 数 组 控制 器 可 以 使 用 自己 的 排序 描 述 符 以 及 选 型 预测 更 改 顺序 和 arrangedObjects 的 内 容 。 


当 单 击 表 头 的 时 候 ， 我 们 想 让 数组 控制 器 更 改 摘 述 符 的 排序 ， 生 成 arrangedObjects。 天 于 它 的 细节 瓯 是 另外 一 个 绑 定 了 。 
选择 表 视 图 、Bindings 查 看 器 和 Sort Descriptor 绑 定 。 将 表 的 排序 描述 绑 定 到 Passer Array、SsortDescriptors。 任 何 表 排序 的 
更 改 (通过 单 击 header) 将 会 更 改 数组 控制 器 的 排序 ， 反 之 亦 然 。 


用 户 应 该 可 以 在 表 中 选择 Passers。 这 么 做 将 会 告诉 Passer Array 控 制 器 更 新 它 选中 的 对 象 。 这 是 另外 一 个 绑 定 。 编 辑 


Selection Indexed， 将 它 绑 定 到 Passer Array，selectionlndexes。 
Wis 不 要 让 复数 影响 你 。 它 是 唯一 可 用 的 绪 定 ， 因 为 没有 勾 选 Selection 一 Multiple， 所 以 最 多 只 能 选中 一 个 Passet。 


最 后 ， 也 是 我 们 最 熟悉 的 : 将 表 的 Content 绑 定 到 Passer Array，arrangedObjects。 这 个 数组 将 会 影响 


NSArrayController 的 排序 和 过 滤 属 性 。 


对 于 单元 格 ， 也 像 乙 前 一 样 操作 (有 一 个 例外 ) : 深入 到 表 、 列 和 表 的 单元 格 视 图 中 ， 它 们 的 视图 泻 染 了 这 一 行 Passer 涉 及 
的 相关 属性 。 绑 定 到 Table Cell View, Model Key Path objectValue.attempts (或 者 单元 格 要 展示 的 Passer 属 性 ， 见 表 
20.1) 。 记 住 不 要 勾 选 Conditionally Sets Editable， 所 以 应 用 程序 不 会 同时 将 数据 标签 填充 到 可 编辑 的 文本 栏 中 (在 这 
里 ，“ 标 签 ”实际 上 是 没有 勾 选 Editable 复 选 框 的 NSTextField) 。 


表 20.1 Passer Table 中 数字 列 的 属性 名 称 
LE L= 
位 标题 属性 
Rating passerRating 


Att attempts 


Comp completions 
Yards yards 

IDs touchdowns 

IN Ts interceptions 


Oa Interface Buildet 知 道 它 管理 的 Passet 对 象 ; Model Key Path 的 自动 完成 功能 会 提示 Passet 属 性 的 名 字 。 这 个 特性 并 不 
稳定 ， 在 我 使 用 的 Xcode 版 本 中 ， 没 有 自动 完成 功能 ， 这 一 栏 由 一 个 灰色 的 感叹 号 标记 。 所 以 当 你 运行 App 的 时 候 ， 单 元 格 就 会 


显示 右边 的 数字 ， 这 一 点 你 不 用 担心 。 


Name 列 中 有 一 个 例外 : Passer 不 包 合 .fullName 属 性 ， 但 是 我 们 也 不 打算 使 用 这 个 属性 。 相 反 ， 我们 又 一 次 使 用 了 Value 
With Pattern ， 不 过 它 针对 两 个 值 lastName 和 firstName。 第 一 步 很 明显 : 打开 Display Pattern Value1 编 辑 器 ， 使 用 Model 


Key Path objectValue.firstName 将 它 绑 定 到 Table Cell View, 
现在 怎么 办 ? 编辑 器 没有 提供 使 用 两 个 值 的 方法 。 


但 是 下 一 个 提供 了 。 绑 定 Display Pattern Value1 添 加 了 一 个 额外 的 绑 定 编辑 器 ，Display Pattern Value2 (等 ) 。 它 也 一 
样 ， 除 了 Model Key Path 是 objectValue.lastName。 


处 理 技巧 在 Display Pattern 栏 : 在 里 面 填 充 (%{valuet}@%{value2}@, 


1. 现 在 的 Document Window 


自从 上 次 Mac Passer Rating 运 行 到 现在 ， 已 经 过 去 了 一 段 时 间 ， 所 以 让 我 们 再 次 运行 : Product 一 Run (ÆR) ， 见 图 
20.6。 


Untitled 


Augusta Autocrats 
Boise Boarcats Passare for the Boise Bearcats 


Fremont Firebugs Warren Harding 97.7623... 
Glendale Centers 

Grand Rapids Gamers Frank Pierce 
Huntington Beach Harriers Abe Lincoln 
Mobile Misfits Cal Coolidge 
Modesto Misanthropes 

Montgomery Music 

Richmond Roustabouts 

Sen Bernardino Stalkers 

Shreveport Seamen 

Spokane Stallions 

Tacoma Touchdoewn-Scorers 

Yonkers Yellowjackets 





图 20.6 ”passet 表 现在 表现 得 不 错 ， 只 有 一 个 问题 


现在 基本 上 束 是 我 们 想 要 的 App。 还 有 些 问 题 在 于 Rating 这 一 列 。passer ratings 这 一 列 没有 限制 ， 超 出 的 部 分 用 省 略 号 蔡 
代 。 一 种 解决 万 法 是 将 rating 从 第 一 个 小 数 点 处 截断 。 我 们 必须 要 在 Passer 中 添加 一 个 格式 化 字符 串 的 属性 吗 ? 


不 。 在 Interface Builder 中 选择 Team Detail 场 景 。 在 Object 库 的 搜索 栏 中 输入 formatter， 找 到 绿色 的 图 标 ， 它 们 代表 针 
对 数字 、 日 期 甚至 比特 值 的 自动 格式 化 器 。 将 一 个 数字 格式 化 器 拖 到 rating 单 元 格 上 ，1B 就 会 将 这 个 格式 化 器 放 在 它 所 属 的 层级 
位 置 显示 rating 的 NSTextField 中 的 NSCell (如 果 它 被 添加 到 了 NSTextField 中 ， 那 么 也 不 是 问题 ) 。 画 布 中 这 个 单元 格 看 
起 来 没有 什么 两 样 ， 但 实际 上 包含 格式 化 器 。 





再 次 运行 Mac Passer Rating， 不 ,我 们 做 得 有 点 过 涉 了 。 现 在 rating 不 显示 小 数 部 分 了 。 我 们 需要 自 定义 格式 化 器 。 
storyboard 的 画布 中 无 法 看 到 格式 化 器 ， 跳 转 栏 或 者 control-shift-click 这 个 单元 格 都 不 会 显示 它 。 你 可 以 在 文档 大 纲 中 找到 
它 。 选 择 它 让 后 将 你 的 注意 力 放 在 Attributes 编 辑 器 上 。 


我 们 之 前 添加 的 格式 化 器 的 属性 是 Behavior OX X 10.4 Default, Style None (避免 10.0+， 它 向 后 兼容 ) 。 我 们 知道 这 种 
设置 不 正确 ， 其 他 风格 也 不 合适 (尽管 Spell Out 风 格 看 起 来 也 不 错 ) 。 因 为 有 了 Unformatted 示 例 栏 位 的 经 验 ， 碍 看 
Formatted 视 图 中 的 结果 。 你 需要 切换 到 OS X 10.4 Custom, 


已 提供 了 很 多 很 多 格式 化 选项 : 正 负 值 ， 对 齐 ， 前 缀 后 缀 字符 串 ， 取 整 策略 等 。 我 们 仅 需 要 一 部 分 设置 (图 20.7) 。 


Y E 回 
Number Formatter 
Behavior | OS X 10.4+ Custom 





Format [+] 









Localize | | Lenient 


Integer Digits ii. 42 |< 
Minimum | Maximum 
Fraction Digits i ilS 


Minimum Maximum 
Symbols Decimal Separator 
Currency Decimal Se... 
Grouping Separator 
Currency Code 
sampe = 3 —o-————— 


1,234.75. 1234.8 | 
Unformatted Formatted 


图 20.7 NSNumberFormattet 有 很 多 自 定义 选项 ,但 是 如 果 你 仅仅 想 让 数字 在 小 数 点 前 后 至 少 显 示 一 位 ， 那 么 只 需要 设置 两 个 选 


项 


我 们 想 要 的 是 小 数 点 前 后 起 码 保留 一 位 : 153.8、14.0、0.3 等 。 这 些 控件 在 Attributes 查 看 器 的 底部 。 对 于 Integer Digits 来 
说 ， 将 Minimum 设 置 为 1，Maximum 设 置 为 ?3， 但 是 不 用 让 格式 化 器 强制 格式 化 。Fraction Digits、Minimum 和 Maximum 应 


再 次 运行 App， 这 回 看 起 来 好 多 了 


Pit ”让 我 们 考虑 本 地 化 的 问题 : 可 能 你 已 经 注意 到 ， 除 非 在 查看 器 的 顶部 显 式 设置 格式 化 字符 串 ， 否 则 你 无 法 控制 组 
Tak (F, USP Ai Saha) 或 者 小 数 分 隔 符 (US 中 用 点 号 分 隔 ) o 


这 是 因为 这 些 标记 都 是 依赖 于 区 域 设置 的 : 有 些 地 区 使 用 空格 或 者 点 号 作为 分 组 符号 ,使 用 过 号 分 隔 小 数 。 它 们 由 系统 级 的 
设置 控制 ， 也 就 是 System Pteferences 的 Language&Region 面 板 。 如 果 你 是 一 个 美国 人 ， 向 德国 用 户 展示 1.345 的 时 候 ， 她 会 认为 
是 “一 千 三 百 四 十 五 ”， 这 是 一 个 非常 大 的 错误 。 系 统 级 的 设置 会 移 除 这 种 可 能 性 。iOS 和 OS X 提 供 了 很 多 格式 化 工具 ， 包 含 合 


适 的 格式 。 不 要 仅仅 使 用 类 似 于 ptintf0 这 类 函数 解决 问题 。 
Game-Table 标 答 


完成 了 Team Detail 视 图 下 部 分 的 内 容 ，game 表 与 我 们 之 前 见 到 的 没有 什么 不 同 。 所 以 我 会 尽快 介绍 这 一 块 。 


Passer 表 下 面 的 标签 包含 所 1 选 passer 的 名 字 。 因 为 passer 表 可 选择 的 范围 被 限制 在 Passer Array 控 制 器 的 selectionlndexes 
中 ， 表 中 的 一 次 单 击 会 将 控制 器 的 selection 键 指向 那 一 行 的 Passer。 


将 一 个 新 标签 放 在 passer 表 下 ， 左 右边 界 与 Passers for 标 签 对 齐 。 让 1B 添 加 缺少 的 约束 。Display Pattern 应 该 为 Games 
played by%{value1}9%。 为 了 节省 时 间 ， 这 次 试用 fulIName: 绑 定 到 Passer Array, selection, fullName, 


Game Array 控 制 器 


是 Passer Array 控 制 器 的 重复 : 被 控制 的 对 象 (ldentity 查 看 器 ) 是 Class Game; 内 容 数 组 (Bindings 查 看 器 ) 是 Passer 
制 器 选中 的 gameArray。 


Pit 它 的 策略 特别 简单 : 它 拉 取 了 passer 的 所 有 game， 而 不 仅仅 是 那些 选中 的 Game。 让 我 们 为 这 样 做 提供 一 个 理由 ， 
并 且 解 决 问题 。 
Game 表 


拖 入 另外 一 个 表 视 图 。 与 底 边 和 侧 边 保持 平 齐 ， 与 game-table 标 等 保持 标准 的 间距 。 不 像 其 他 视图 ，game 表 的 高 度 没有 
约束 (无论 是 显示 的 还 是 基于 内 容 的 ) ， 所 以 能 灵活 地 让 文档 窗口 更 改 高 度 。 


列 应 该 是 Us (Game 的 teamName 属 性 和 ourScore， 使 用 %{value1}@-%{value2}@ 格 式 化 ) ; Them (与 Us 一 样 ， 除 了 
使 用 theirTeam 作 为 名 称 ) ; When (whenPlayed) 和 Rating (Game 计 算 测 出 的 passerRating 属 性 ) 。 


运行 Mac Passer Rating。 图 20.8 中 显示 了 Herbert Hoover 的 可 怜 记 录 ， 因 为 他 被 联盟 剔除 了 。 这 里 显示 不 仪 仪 是 他 的 技 
木 问题 。 


Untitled 2 Edited 
Augusta Autocrats 
Boise Bearcats Passers for the Augusta Autocrats 
Des Moin...peradoes Name Rating Att Comp | Yards 
Fremont Firebugs Herbert Hoover 64.6 4B 23 260 
Glendale Centers Tom Wilson 62.6 3,521 1,548 13,568 


Grand Rapids Gamers |John Tyler 81.4 163 67 64 
Huntingto...h Harriers 


Mobile Misfits 

Modesto Misanthropes 

Montgomery Music Games played by Herbert Hoover 

Richmon...ustabouts Ue Them When Rating 

san Bern...o Stalkers Augusta Autocrats-8 Grand Rapids G... Monday 77.9 

Shreveport Seamen Augusta Autocrats- 14 Huntington Bea... Monday 57.2 

Spokane Stallions Augusta Autocrats-9 Modesto Misant... Monday, 39.6 

Tacoma T...n-Scorers Augusta Autocrats- 7 Fremont Firebug... Monday, 58.0 

Yonkers Yellowjackets | Augusta Autocrats-9 Richmond Rous... Monday, 82.3 
Augusta Autocrats-0 Shreveport Sea... Monday, 66.7 
Augusta Autocrats-8 Grand Rapids G... Monday 39.6 
Augusta Autocrats - 9 San Bernardino... Monday, 54.6 
Augusta Autocrats-8& Tacoma Touchd... Monday, 39.6 





图 20.8 ”game 表 需要 花费 一 些 时 间 来 格式 化 


几乎 第 二 列 所 有 的 team 名 称 和 分 数 都 超过 了 列 的 显示 范围， 后面 的 内 容 用 省 上 略 号 截断 。 对 于 数字 来 说 还 可 以 接受 ， 因 为 它 
们 的 小 数 部 分 没有 那么 重要 。 在 这 个 例子 中 ， 即 便 被 和 截断， 用户 还 是 能 分 辨 出 team 的 名 称 ， 但 是 分 数 不 行 ， 分 数 是 非常 重要 的 


信息 。 
同样 ， 所 有 的 日 期 都 是 Monday。 它 们 都 被 截断 了 ， 完 整 的 格式 包含 一 星期 中 的 第 儿 天 ， 它 也 不 是 很 有 用 |。 


我 确定 你 注意 到 了 除了 的 数字 格式 化 器 ，Interface Builder 还 会 让 你 使 用 日 期 格式 化 器 。 将 一 个 日 期 格式 化 器 拖 到 When 单 
元 格 ， 在 Attributes 查 看 器 中 ， 将 它 设置 为 : 


- Behavior: OS X 10.4+Default. 


- Date Style: Medium 





查看 Sample 视 图 的 效果 。 
- Relative Data: 不 。 你 想 要 使 用 上 日历 上 日期， 即使 它 也 可 以 被 称 为 Yestetday。 


` Time Style: No Time Style。 足 球 队 一 天 最 多 只 能 打 一 场 比赛 ， 所 以 时 间 不 重要 。 除 此 之 外 ， 显 示 时 间 就 无 法 让 数据 作 商 ， 
比如 将 每 场 比赛 的 时 间 设 置 在 午夜 。 


像 Them 列 一 样 ， 你 可 以 控制 NSTextFields ( 它 包 含 标签 ) 的 截断 规则 。 选 择 Them 单 元 格 的 文本 域内 容 ， 同 时 使 用 
Attributes 查 看 器 将 Layout 设 置 为 Truncates (而 不 是 将 它 放 在 额外 的 一 行 或 者 让 内 容 滚 动 ) 和 Line Break Truncate Middle, 
这 会 将 椭圆 放 在 team-andscore 单 元 格 的 中 间 ， 显 示 出 团队 的 名 字 和 分 数 。 


在 Us 列 执 行 相同 的 操作 。 


现在 你 已 经 有 了 表 (包括 表 头 ) 和 Game Array 控 制 器 ， 你 可 以 按照 喜欢 的 方式 绑 定 排序 摘 述 符 。 对 于 Us 和 Them 列 来 说 ， 
我 推荐 按照 各 目的 队伍 名 称 排序 。 


这 样 ， 我 们 就 得 到 了 图 19.1 所 示 的 文档 窗口 。 


20.5 ”小 结 


Binding 功 能 极 大 地 方便 了 OS X 编 程 ， 这 么 长 的 一 章 甚至 都 无 法 面面俱到 。 在 本 章 中 ， 我 先 介绍 了 binding 能 为 你 做 什么 ， 
在 这 之 后 ， 我 义 着 重 讲 了 Xcode 为 这 个 功能 提供 了 哪些 支持 。 可 以 在 代码 中 建立 binding， 但 Interface Builder 是 让 它们 正确 工 
作 不 可 或 缺 的 工具 ， 最 简单 (相对 来 说) 也 最 快捷 。 


我 也 介绍 了 绑 定 和 格式 化 器 如 何 修 改 模型 类 不 直接 支持 的 数据 格式 ， 将 你 从 为 了 适 配 变 量 的 表现 形式 而 更 改 模 型 的 “ 泥 
沼 ” 中 解救 出 来 。 


使 用 数字 和 日 期 格式 化 器 截断 控件 中 过 长 的 内 容 ， 用 它们 来 控制 表 中 单元 格 和 标签 的 显示 万 式 。 


Bole 本 地 化 


我 非常 喜欢 Mac Passer Rating 这 个 应 用 ， 至 少 很 适合 用 来 作为 例子 ， 如 果 它 能 以 法 语 呈 现 将 会 更 完美 (在 Québec 踢 足 
球 ) 一 一 即 变 成 名 叫 Quart-Efficacité 的 应 用 。OS X 用 户 可 以 在 System Preferences 应 用 程序 中 Language&Region 面 板 下 的 
Language 选 项 卡 里 面 ， 通 过 可 用 的 语言 列表 指定 他 们 能 够 理解 的 语言 。 当 用 户 将 法 语 的 优先 级 设置 得 比 瑞 语 高 ， 那 么 我 希望 


MPR 能 够 用 法 语 展 示 荣 单 、 和 敬告、 标签 等 。 
加 注意 接 下 来 展示 给 你 们 的 本 地 化 技术 和 你 们 在 iOS 应 用 上 使 用 的 一 样 。 


本 章 的 计划 如 下 : 首先 ,我 将 给 你 们 展示 Cocoa 框 染 中 本 地 化 的 核心 概念 ， 接 着 ,我 会 告诉 你 们 “ 它 的 实现 方式 ”， 即 
Cocoa 框 染 使 用 的 拷 术 ， 如 何 找到 并 使 用 合适 的 译文 和 布局 ; 之 后 介绍 Xcode 如 何 帮 助 你 创建 Cocoa 本 地 化 所 需 的 文件 完成 整个 
工作 。 你 将 知道 应 该 会 产生 什么 结果 。 


然后 我 会 很 简明 地 告诉 你 ， 为 什么 不 必 以 某 种 方式 去 做 某 些 事 ， 以 及 为 什么 不 应 该 那么 做 。 


21.1 本 地 化 的 工作 原理 


Cocoa 应 用 通过 NSBundle 类 下 载 资源 。 当 需要 某 种 资源 时 ，NSBundle 首 先 会 按照 用 户 的 语言 偏好 搜索 应 用 包 Resources 
目录 的 子 目 录 。 语 言 子 目录 名 称 的 格式 都 很 特别 ， 例 如 : English.lproj、fr.lproj 或 者 en-GB.lproj。 不 允许 纯 文本 的 语言 名 称 ， 
你 应 当 使 用 ISO 标 准 的 语言 缩写 ， 还 可 以 使 用 后 经 码 指定 不 同 的 区 域 。 


如 果 找 不 到 匹配 用 户 语言 和 地 区 的 目录 (例如 与 Canadian French 对 应 的 fr-CA.lproj) , OS X 会 尝试 只 根据 语言 变量 
(fr.lproj) 寻找 相应 的 目录 ; 然后 下 载 匹 配 用 户 语言 偏好 的 资源 列表 ; 再 进入 base localization (在 Base.lproj 中 ) ; 最 后 处 理 


未 本 地 化 的 贷 源 中 的 字符 串 和 布局 ， 它 们 不 在 任何 以 .lproj 结 尾 的 目录 中 。 
如 果 在 Finder 中 查看 Mac Passer Rating 有 目标 文件 目录 ， 你 会 看 到 Base.lproj 目 录 中 包 合 了 Main.storyboard，。 


在 Interface Builder 中 打开 Main.storyboard， 查 看 Editor 区 域 上 方 的 跳 转 栏 。 和 你 预期 的 一 样 ， 从 整个 项 目的 总 目录 开 
台 ， 一 层 层 打开 目录 后 ， 到 这 个 文件 本 身 。 但 是 还 有 另 一 层 文 件 : 与 这 个 文件 有 相同 的 名 字 ， 只 不 过 多 了 一 个 后 缀 (Base) 。 
对 Xcode 来 说 ， 你 看 到 的 只 是 那个 文件 中 众多 语言 中 的 一 种 一 一 出 现在 Base.lproj 中 的 那 一 个 。 


四 注意 如 果 你 自己 创建 了 一 个 未 本 地 化 的 资源 ，Xcode 不 会 一 开始 就 将 它 本 地 化 。 不 要 试图 手动 将 它 移 动 到 一 个 lptoj 文 件 
来 中 。 如 果 这 么 做 了 ， 好 点 的 情况 是 ，Project navipgatot 中 该 文件 名 会 变 红 ， 意 味 着 Xcode 找 不 到 该 文件 ; 当 出 现 了 这 种 情况 ， 解 
决 方法 是 先 选中 红色 标签 ， 再 在 File 查 看 器 中 单 击 小 的 文件 天 按钮 。 更 差 的 情况 是 ， 你 可 能 会 弄 乱 本 地 化 机 制 。 经 验 表明 ， 如 果 
背 着 Xcode 执行 资源 本 地 化 操作 ， 那 么 Xcode 会 变 得 很 脆弱 。 正 常情 况 下 会 一 帆 风 顺 ， 但 不 要 挑战 现 有 的 规则 。 


21.2 ”添加 本 地 化 


Xcode 早期 的 版 本 (Xcode 3 之 前 ) 都 是 基于 文件 来 本 地 化 的 ; 你 可 以 把 同名 的 文件 ， 比 如 Main.storyboard、Credits.rtf 
放 到 不 同 的 Iproj 文 件 夹 中 ， 这 些 都 是 你 的 工作 。Xcode 不 会 注意 到 它们 之 间 的 天 系 。 


这 样 做 有 两 方面 满足 不 了 项 目的 需求 : 第 一 ， 很 不 方便 ， 比 如 你 正在 处 理 某 资源 的 英文 版 本 ， 同 时 你 还 想 处 理 法 语 版 本 的 工 
作 ; 第 二 ， 国 际 化 的 要 点 是 生产 一 个 产品 ， 这 个 产品 要 符合 用 户 的 语言 环境 ， 从 概念 上 说 ， 你 并 不 是 要 国际 化 一 个 文件 ， 而 是 要 
际 化 整个 项 目 。 现 在 Xcode 将 本 地 化 的 过 程 作为 整个 项 目的 属性 ， 而 不 是 基于 文件 处 理 。 


21.2.1 Base Localization 


Xcode 本 地 化 从 base localization 开 始 ， 原 因 是 base localization 文 件 包 含 了 可 本 地 化 资源 的 基础 结构 ， 而 特定 的 语言 /地 
区 文件 包含 了 该 语言 地 区 的 本 地 化 细节 : Base.lproj 包 含 了 Main.storyboard， 它 指明 了 整个 应 用 的 布局 ， 除 了 文档 窗口 本 身 。 


9 注意 ”storyboard 中 的 字符 串 都 是 英文 格式 ， 这 是 因为 Xcode 一 开始 就 是 英文 版 本 ; 它 在 Base localization 中 因为 它 是 官方 的 
布局 格式 。 


法 语 本 地 化 会 在 同样 的 storyboard 中 使 用 同样 的 布局 ， 你 不 需要 重新 设置 布局 。 你 只 需要 提供 一 个 .strings 文 件 ，Cocoa 会 
使 用 它 来 为 法 语 用 尸 蔡 换 相 应 的 文本 。 


D+ 如 果 你 正 处 理 一 个 老 项 目 ， 那 么 不 会 有 Base localization。 如 果 你 在 Ptoject editot 的 Info 选 项 卡 下 勾 选 了 Use Base 
Internationalization 复 选 框 ，Xcode 会 从 现在 开始 本 地 化 操作 。 它 会 展示 它 认为 可 以 本 地 化 的 所 有 文件 ， 并 且 询 问 你 是 想 将 它们 保 
存在 英语 的 本 地 化 文件 中 还 是 移动 到 Base 中 ; 如 果 你 想 要 移动 到 Base 中 ， 你 是 否 想 要 创建 一 个 .strings 文 件 来 从 Base 内 容 中 分 离 出 
英语 内 容 。 原 则 上 ，Base 的 内 容 不 属于 任何 一 种 语言 。 


21.2.2 ”为 什么 需要 Base Localization 


之 所 以 使 用 Base localization 是 基于 一 条 原则 : 你 应 该 有 一 套 资 源 (其 中 storyboards 和 XIBs 是 其 中 最 重要 的 ) ， 它 们 是 应 
用 的 核心 ， 并 且 能 提供 足够 的 信息 来 弥补 各 个 版 本 本 地 化 之 间 的 不 同 。 这 要 比 为 不 同 语言 地 区 的 本 地 化 直接 复制 这 些 资 源 容 易 得 


多 。 





你 也 许 有 很 多 理由 想 要 为 另 一 种 语言 复制 整个 布局 一 我 乙 前 提 到 的 文化 差异 残 是 很 好 的 理由 ， 但 通 音 你 不 需要 这 人 么 做 ， 
你 也 不 应 该 这 么 做 。 举 一 个 极端 的 例子 : 你 想 要 在 三 四 个 脚本 中 支持 12 种 语言 (RURAL, FBR ERI DAME Na] 
题 ) ， 那 残 是 12 种 布局 。 现 在 向 其 中 一 个 布局 添加 一 排 按钮 ， 然 后 再 添加 到 其 他 布局 中 。 记 住 你 还 需要 为 每 个 布局 连接 控件 和 
对 应 的 动作 。 


不 ， 你 一 定 不 愿意 这 么 做 。 





多 种 布局 还 有 一 个 经 典 的 理由 一 一 同样 的 想法 在 CJK 脚 本 中 表达 出 来 只 要 两 个 字符 ， 但 是 在 德语 中 会 很 长 。 一 些 开 友 者 通过 
为 德语 扩大 视图 来 解决 这 个 问题 ， 如 果 这 人 么 做 融 意 味 痢 日 本 语 会 在 很 宽 的 对 话 框 中 只 鼎 一 小 部 分 ， 这 并 没有 什么 帮助 。 大 多 数 的 
开 上 友 痢 也 不 会 这 人 么 做 。 


在 从 石 到 左 布 局 的 脚本 案例 (阿拉伯 语 、 希 伯 来 语 ) 中 ， 复 制 布局 似乎 不 可 避免 。 OK 按钮 要 在 左下 角 而 不 是 像 L-T-R 的 布局 
在 右 下 角 。 


你 还 记得 12 章 中 的 痛苦 吗 ? 那 的 确 是 一 个 极端 的 案例 ; 对 于 Mac Passer Rating 来 说 ，Interface Builder 提 供 的 默认 约束 已 
经 足够 了 。 然 而 现在 就 是 它 回报 我 们 的 时 候 : 正如 iOS 的 size 类 人 允许 你 为 完全 不 同 的 布局 使 用 相同 的 storyboard， 相 同 的 
storyboard 能 为 日 文 、 阿 拉 伯 语 、 德 语 生成 正确 的 布局 : 还 记得 包含 文本 的 视图 的 耐 压 性 吗 ? 较 长 的 德语 标签 会 拓宽 封闭 的 视 
图 来 创造 空间 (在 必要 的 情况 下 ， 会 溢出 与 窗口 的 边界 重 蔷 ) 。 


如 果 你 正确 地 设置 了 Auto Layout， 你 的 视图 会 适应 相当 大 的 文本 ， 见 图 21.1。 


如 何 处 理 希 伯 来 语 呢 ”还 记得 所 有 的 水 平 距离 约束 都 描述 为 leading 和 trailing， 而 不 是 left 和 right”Auto Layout 知 道 在 希 
伯 来 语 中 ， 控 件 和 文本 的 leading 侧 在 右边 。 如 果 操 作 正 确 ，Auto Layout 会 自动 为 从 右 到 左 布局 的 脚本 设置 布局 。 


Monday, 23 March 2020 

Augusta Autocrats 

Huntington Beach Harriers 

Attempts 9 Completions 


Yards 39 


Touchées, qui sont des choses vraiment a desirer 0 Interceptions 





图 21.1 通过 正确 的 Auto Layout, game-views# h JE MAL AAA, PERA P PAR ANKE TAA RH 


21.3 ”哪些 需要 本 地 化 


我 又 告诉 了 你 们 一 遍 (难道 没有 ? ) Auto Layout 的 好 处 。 就 Mac Passer Rating 来 说 并 没有 充分 利用 Auto Layout: ER 
需要 确保 控件 之 间 相 互 挨 着 ， 很 难 有 布局 对 文本 造成 困扰 。 


21.3.1 ”游戏 细 书 视图 : 布局 


很 幸运 (为 了 演示 的 目的 ) ， 在 图 19.1 的 计划 里 缺少 一 块 : 一 个 展示 比赛 细节 的 弹出 窗口 ， 该 比赛 需要 从 团队 细节 视图 


(team detail view) 下 方 的 表格 中 选 出 。 


这 瓯 需要 另 一 个 视图 控制 器 。 将 一 个 View Controller 场 景 拖 到 Main.storyboard 男 布 中 。 使 用 Identity inspector 将 控制 器 
的 Class 设 置 为 GameDetailController， 对 应 的 类 文件 会 立刻 生成 。 


Oe 注意 下 方 的 Module 栏 ， 它 是 空 的 ， 只 有 一 个 None 占 位 符 。 这 在 之 后 会 讲 到 。 


将 场景 根 视图 的 宽度 设置 为 360， 高 度 设置 为 220。 将 标签 拖 到 视图 的 上 半 部 分 ， 如 图 21.2 所 示 ， 拖 动 MacStatViews 到 下 半 
部 分 。 如 果 在 分 数 标签 上 添加 NSNumber Formatters 会 更 好 ， 让 分 数 标签 以 Decimal 的 形式 显示 。 为 了 演示 本 地 化 的 布局 ， 你 
必须 为 日 期 标签 添加 一 个 Full 日 期 格式 (没有 时 间 格 式 ) 的 NSDateFormatter。 


Date 

our team our score 

their team their score 
Attempts 12,332| | Completions 8,433 


Yards 41,932 


Touchdowns 230) Interceptions 200 











图 21.2 Game Detail 场 景 做 的 不 是 很 精细 ; 上 半 部 分 为 标签 ， 下 半 部 分 是 MacStatViews 


又 一 次 ， 我 将 创建 一 个 StatView 标 签 和 数字 视图 (label-and-number view) 类 的 OS X 版 本 MacStatView， 来 打破 约束 。 
除 为 了 适应 AppkKit 而 不 是 UIKit 的 更 改 外 ， 没 有 太 多 需要 了 解 的 ; 你 可 以 在 本 章 的 示例 代码 中 找到 MacStatView.swift。 


让 我 们 看 看 在 以 下 的 约束 中 我 们 能 多 快 创建 这 个 场景 : 
“ 在 最 顶部 创建 日 期 标签 ， 注 意 它 与 整个 封闭 视图 的 顶端 与 侧 边 毕 的 标准 距离 。 
“ 对 于 日 期 标签 下 的 视图 ， 左 边 视图 的 leading 边 缘 要 和 日 期 的 leading 边 缘 对 齐 ， 它 们 的 trailing 边 缘 各 自 独立 。 
- 右边 视图 的 trailing 边 缘 要 和 日 期 trailing 边 缘 对 齐 ， 它 们 的 leading 边 缘 各 自 独立 。 


. 使 所 有 的 stat views 有 相等 的 高 度 和 宽度 。 


` 


- 为 每 一 个 stat views 设 置 一 个 最 小 宽度 ， 例 如 : 110 point， 最 小 高 度 25 point。 以 上 的 尺寸 约束 是 在 LCH 弹出 窗口 中 完成 
的 。 那 是 一 个 绝对 约束 ; 可 将 它 转 化 成 最 小 约束 : 选择 约束 ， 然 后 在 Atttibutes 查 看 器 中 修改 Relation 弹 出 框 为 Gteatet Than or 
Equal. 


` 左 侧 的 视图 会 决定 其 他 控件 的 垂直 距离 : 
` 将 日 期 和 团队 姓名 标签 之 间 固 定 为 8 points。 
+ 将 团队 姓名 标签 的 基准 线 与 它们 各 自 的 分 数 标签 对 齐 。 
将 MacStatViews 的 左上 边缘 和 周围 控件 的 右边 对 齐 。 
:将 Touchdqowns stat view 的 底 边 缘 与 整个 视图 的 底 边 缘 固 定 在 一 个 标准 距离 。 
- Interface Buildet 仍 会 抱怨 stat views 的 宽度 或 者 水 平 距 离 难 以 控制 。 这 里 有 一 个 技巧 : 
- 从 Attempts stat view 中 拖 动 一 个 约束 到 容器 视图 上 。 先 不 管 它们 之 间 的 关系 是 什么 ， 因 为 你 蕊 上 就 会 修改 它 。 


` 选择 新 的 约束 ， 然 后 在 Attributes 查 看 器 中 将 它 修改 为 First Item: MacStatView.Trailing;Relation:Equal;Second 
Item:Supetview.Centet X;Constant:-8 (如 果 视 图 的 顺 厅 不对， 就 在 其 中 一 个 条 目的 弹出 窗口 中 选择 Reverse First and Second Item) 。 


你 看 了 之 后 意思 就 很 明确 了 : stat view 的 trailing 边 缘 与 整个 容器 中 间 偏 左 8 point 对 齐 。 
- 固定 Attempts 和 Completions 之 间 的 水 平 距离 为 16， 这 样 就 能 保证 Completions 与 整个 视图 的 中 间 偏 右 8 point 对 齐 。 
其 他 stat views 的 边缘 将 相对 于 Attempts 或 者 Completions 来 固定， 它们 的 布局 将 是 固定 的 。 


. 所 有 的 stat view 具 有 相同 的 宽度 约束 会 确保 它们 与 最 长 的 视图 (拥有 最 长 的 内 容 ) 一 样 帘 ， 那 是 因为 它们 有 的 耐 压力 
(compression-resistance) 约束 (可 以 从 其 中 选择 一 个 并 在 Size 查 看 器 中 查看 ) ; 反之 ， 这 也 会 扩大 外 部 整个 视图 的 宽度 来 容纳 内 


部 包含 的 视图 。 


最 后 ， 从 Team Detail 场 景 拖 动 控件 到 新 的 Game Detail 场 景 中 ， 为 生成 的 segue 采 用 Popover 风 格 。 选 中 segue 并 在 
Attributes inspector 中 将 其 命名 为 Show game popover。 


同时 ， 可 通过 拖 动 那个 区 域 的 连接 气泡 到 Team Detail 场 景 的 游戏 表格 中 ， 来 设置 Anchor View。 它 会 将 表 显示 在 弹出 框 显 
示 的 位 置 。 因 为 我 们 想 要 弹出 框 出 现在 表格 的 右边 ， 所 以 将 Preferred Edge 设 置 为 Right。 


21.3.2 PRAPME: 代码 


我 们 有 了 游戏 细节 视图 的 布局 ， 但 没有 相应 的 代码 。 创 建 一 个 新 类 GameDetail Controller， 它 是 NSViewController 的 一 
个 子 类 。 首 先 声明 一 个 game 属 性 ， 然 后 再 为 已 经 存在 的 NSViewController 属 性 representedObject 添 加 一 个 修饰 符 : 


var game: Game! 
override var representedObject: AnyObject? { 
didSet { 
game = representedObject as? Game 
// loadStatViews () 


现在 已 经 有 了 一 个 game 属 性 ， 并 将 representedObject 转 换 为 了 Game 类 型 ， 这 样 会 很 方便 。 


但 是 首先 为 MacstatViews 添 加 一 个 @IBOutlets。 现 在 这 对 你 来 说 应 当 很 简单 : 打开 辅助 编辑 器 ， 将 焦点 放 在 新 的 
GameDetailController.Swift 文 件 上 〈 它 应 当 是 跳 转 栏 Automatic 选 项 中 的 一 个 ) 。 从 每 一 个 stat view 拖 动 到 类 定义 中 ， 分 别 
修改 它们 的 名 字 : 


@IBOutlet weak var attemptsView: MacStatView! 
@IBOutlet weak var yardsView: MacStatView! 
@ITBOutlet weak var touchdownsView: MacStatView! 
@IBOutlet weak var completionsView: MacStatView! 
@IBOutlet weak var interceptionsView: MacStatView! 


那 上 半 部 分 的 标签 呢 ” 试 试 这 样 : 拖 动 项 部 的 日 期 标签 到 GameDetailController 的 game 属 性 声明 中 。 这 个 属性 定义 本 身 应 


会 局 亮 显示 ， 见 图 21.3 上 。 
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图 21.3 ”将 带 有 key-value 绑 定 的 视图 使 用 conttol-dtag 的 操作 拖 动 到 控制 器 类 的 key-value 必 性 上 就 能 将 它们 绑 定 。 即 使 这 个 控制 器 类 


并 不 是 NSControllet 的 一 个 子 类 


Interface Builder 提 供 将 标签 与 game 属 性 绑 定 的 功能 。 用 两 个 手 来 操作 : 将 Bind 改 为 Value (你 可 以 选择 视图 中 任何 可 比 
定 的 属性 ) ; GameDetailController 下 面 一 栏 填 self; 


为 值 设置 为 Key Path game.whenPlayed。 单 击 Connect 按 钮 。 


Oa 为 什么 我 没有 在 20 章 中 告诉 你 们 这 个 方法 ? 在 那 一 章 中 ， 我 们 正 连接 一 系列 选中 的 对 象 ， 集 合 中 的 对 象 都 集中 在 
排序 和 添加 到 attangedObjects 的 操作 中 。NSConttollef 类 主要 用 于 这 些 概念 ， 而 不 仅 是 两 个 对 象 之 间 的 直接 访问 。 


对 团队 name 和 Score 标签 做 同样 的 处 理 : game.team.teamName,game.our-Score,game.theirTeam,and 


game.theirScore, 


stat views 必 须 以 通常 的 方法 来 填充 。 在 GameDetailController 中 添加 loadStatViews， 在 didset 中 取消 对 
representedObject 的 调用 ， 并 添加 一 个 对 viewDidLoad 的 调用 : 


func loadStatViews() { 
if attemptsView == nil || game == nil { return } 


attemptsView.numericValue = game.attempts as! Int 
yardsView.numericValue = game.yards as! Int 
touchdownsView.numericValue = game.touchdowns as! Int 
completionsView.numericValue = game.completions as! Int 
interceptionsView.numericValue = game.interceptions as! Int 


override func viewDidLoad() { 
super. viewDidLoad () 
loadStatViews () 


此 外 ， 添 加 一 个 方法 来 触 友 弹 出 窗口 。Yosemite 版 本 添加 了 手势 识别 ，iOS 很 早 以 前 就 有 这 个 功能 了 。 手 势 识 别 器 能 够 检测 
出 视图 中 妃 标 和 触摸 板 手势 触摸 的 对 象 。 在 Interface Builder 对 象 库 中 有 识别 器 的 全 部 功能 。 在 搜索 区 域 输 入 gest， 拖 动 一 个 氮 
击 识别 器 到 TeamDetail Controller 场 景 的 game 表 格 中 。 


Interface Builder 选 择 了 新 的 识别 器 ， 在 Attributes 查 看 器 中 ， 将 它 与 Primary 按 钮 配对 ， 需 要 两 次 单 击 并 且 确 保 功 能 开局 
(Enabled) 。 双 击 识别 器 没 办 法 区 分 双击 (应 当 触 友 识 别 器 ) 和 单 击 (应 当 穿 过 识别 器 传送 到 视图 上 ) ; 它 不 得 不 延迟 单 击 事 
件 的 传递 直到 等 待 第 二 次 单 击 的 时 间 耗 尽 。 这 个 对 于 本 次 设计 来 说 不 成 问题 一 一 因为 它 是 唯一 的 识别 器 ， 并 且 它 本 身 也 需要 单 
击 一 一 所 以 忽略 Delays Events 复 选 框 。 





让 手势 工作 的 最 简单 的 方法 就 是 把 手势 当成 一 个 控制 事件 ， 类 似 于 单 击 一 个 按钮 。 使 用 control-drag 操 作 将 识别 器 控件 拖 到 
TeampDetailController.swift 中 ， 并 且 计 上 1B 创建 一 个 名 为 gameTableClicked 的 IBAction。 


private let kGamePopoverSegue = "Show game popover" 
@TBOutlet weak var gameTable: NSTableView! 


@IBAction func gameTableClicked (sender: NSClickGestureRecognizer) { 
// What row was clicked? (If < 0, none was.) 
let location = sender. locationInView(sender.view! ) 
let row = gameTable.rowAtPoint (location) 


if row >= 0 { 
// Get the game for that row and trigger the popover segue. 
let game = gameArrayController.arrangedObjects [row] as? Game 
if let theGame = game { 
self .performSegueWithIidentifier (kGamePopoverSegue, 
sender: theGame) 


此 外 我 给 game 表 添加 了 一 个 outlet， 因 为 gameTableClicked 需 要 引用 它 。 如 果 这 个 单 击 对 应 于 一 个 Game， 那 么 
gameTableClicked 就 会 触发 Show gamepopover 这 个 segue， 也 就 意味 着 应 当 有 一 个 prepareForSegue 方 法 来 设置 转换 的 细 


-=j 
TJ 


override 
func prepareForSegue (segue: NSStoryboardSegue, 
sender: AnyObject?) { 
if let segueID = segue.identifier { 
switch seguelID { 
case kGamePopoversegue: 
let popoverController = segue.destinationController 
as GameDetailController 
popoverController.representedObject = sender as! Game 
default: 
printin ("Unrecognized segue identifier \"\(seguelID) \"") 


} 


} 


wits 记 住 ， 如 果 你 输入 ptepateFotSegue 并 且 触 发 自动 完成 ， 那 么 Xcode 会 给 你 提供 这 个 方法 的 全 部 接口 ， 包 括 ovettide、 
func 及 参数 标签 。Xcode 尽 力 提 供 范围 修饰 符 和 履 盖 等 操作 ， 这 帮 了 我 们 大 忙 。 相 反 ， 记 住 不 要 手动 输入 func 或 者 修饰 符 : Xcode 
会 重复 插入 并 且 提 示 有 语法 错误 ， 直 到 你 改正 过 来 。 


运行 Mac Passer Rating， 必 要 时 载 入 带 有 测试 数据 的 文档 (Edit 一 Fillwith Test Data, ¢6T) 。 选 择 一 个 team 和 一 个 


passer， 单 击 一 个 game。 


21.3.3 ”模块 和 命名 空间 
控制 台 提 示 运 行 出 错 : 


Unknown class GameDetailController in Interface Builder file at 
path/Users/fritza/Library/Developer/Xcode/DerivedData/http://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... 


它 会 报 一 系列 错误 ， 如 果 你 不 知道 去 哪里 查看 ， 将 很 难 找 出 问题 的 原因 。GameDetail Controller FAERIE? 你 可 能 
会 在 这 条 消息 的 同一 窗口 查看 GameDetailController.swift。 


Objective-C 存 在 这 样 的 问题 : 所 有 的 类 都 属于 相同 的 命名 空间 。 这 就 是 为 什么 要 避免 使 用 大 众 的 类 名 ,例如 Shape， 如 果 
使 用 这 个 名 字 创 建 一 个 类 ， 很 有 可 能 你 的 App 会 链接 其 他 库 中 使 用 相同 名 字 的 不 同类 。 一 般 的 解决 方案 是 在 所 有 的 类 名 称 前 添加 


字母 来 避免 冲突 。 


Foundation 和 AppkKit 使 用 NS，UIKit 使 用 UI。.Apple 推 荐 开 友 者 使 用 3 个 字母 作为 类 的 前 级 ， 这 将 会 大 大 降低 类 名 冲突 的 可 
能 性 (但 没有 更 好 地 办 法 了 ) 。 


Swift 使 用 了 命名 空间 。 每 一 个 类 都 属于 某 个 module (模块 ) ， 同 一 个 模块 内 的 类 名 也 不 能 重复 ， 但 是 不 同 模块 内 类 的 名 称 
相同 也 不 会 相互 影响 。 如 果 你 需要 访问 另外 一 个 模块 的 内 容 ， 那 么 将 它 导 入 需要 使 用 它 的 Swift 文 件 中 ， 例 如 import Cocoa。 你 
可 以 访问 其 他 模块 中 的 对 象 ， 只 要 它们 被 申明 为 public 即 可 ;如 果 对 象 的 名 称 与 你 目 己 的 冲突 ， 残 不 得 不 在 名 字 之 前 附 上 模块 名 


字 和 一 个 点 。 


你 的 应 用 有 一 个 默认 模块 ， 它 的 名 称 一 般 与 应 用 程序 的 名 称 相同 ， 非 字母 数字 的 字符 使 用 下 划 线 蔡 代 。 在 Mac Passer 
Rating 这 个 例子 中 ， 应 用 程序 模块 名 为 Mac Passer Rating. 


现在 有 一 个 问题 : 我 们 在 定义 类 之 前 创建 了 GameDetailController 场 景 。 当 我 们 告诉 Interface Builder 这 个 类 是 
GameDetailController 的 时 候 ， 还 没有 这 个 类 ， 并 且 1B 不 知道 去 哪里 可 以 找到 这 个 类 。 所 以 正如 我 们 之 前 所 见 一 一 1dentity 查 看 


器 中 的 Module 栏 是 空 的 。 


GameDetailController 在 Mac Passer Rating 模块 中 ; 在 Module 栏 中 输入 这 个 名 字 ， 或 者 重新 输入 类 名 ， 这 会 提示 
Interface Builder 补 全 模块 名 。 


再 次 运行 这 个 程序 并 选择 一 场 比 赛 ， 束 会 出 现 你 期 望 的 弹出 窗口 。 


21.4 ”法 语 本 地 化 


这 一 部 分 将 会 告诉 你 Mac Passer Rating 本 地 化 的 过 程 。 稍 后 我 们 会 了 解 到 Finder (或 者 iOS 主 界面 ) 是 如 何 处 理 的。 首先 
我 们 会 辐 项 目 结构 中 添加 另 一 种 语言 ， 然 后 再 处 理 主 界面 、 文 件 资 源 及 应 用 内 代码 。 


21.4.1 ”添加 语言 环境 
当 你 打开 Project editor (选择 Project 导 航 栏 中 顶端 的 一 项 ， 表 选择 顶部 的 整个 项 目的 图 标 ) ， 表单 击 Localizations 表 格 下 


方 的 + 按钮 ， 本 地 化 就 开始 了 。 使 用 Editor 一 Add Localization 命 令 也 会 产生 同样 的 效果 : 可 供 选 择 的 语言 的 排列 顺序 先是 一 些 
常见 的 语言 ， 然 后 是 数量 庞大 的 不 常见 语言 ， 见 图 21.4. 
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图 21.4 ”通过 单 击 Project editor 中 Localizations 表 格 下 方 的 二 按钮 来 添加 本 地 化 功能 ， 或 者 使 用 Editor 一 Add Localization 命 令 并 且 选 
择 具 体 的 语言 环境 。 需 要 从 很 多 种 中 选择 


Og 开始 时 项 目 只 有 一 个 文件 Main.stotyboatd 在 Base.lptoj 目录 中 ， 因 此 只 有 一 个 资源 被 认为 是 可 本 地 化 的 。 为 了 添加 多 
样 性 ， 我 已 经 在 示例 代码 的 Base.lptoj 目录 中 添加 了 Crtredits.ttf 文 件 (Xcode 的 旧版 本 将 这 个 文件 作为 应 用 模板 的 一 部 分 ) 。App 模 
A bouthttp: //www.hzcourse.com/resoutce/teadBook?path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... %-# 
项 和 应 用 程序 的 方法 orderFrontStandardAboutPanel 连 在 一 起 : 也 就 是 将 这 个 菜单 项 与 About box 放 到 一 起 。 如 果 它 发 现 了 一 个 
Credits.ttf、.rtfd 或 .html 文 件 ， 它 的 内 容 就 会 被 添加 到 About 的 内 容 框 中 。 





你 看 到 的 不 仅 是 一 语言 列表 一 一 Butkina 和 Faso Chad 地 区 的 法 语 方言 没有 大 的 区 别 ， 但 是 需要 本 地 化 的 不 仅仅 是 语言 ， 这 是 
一 个 locale (KIX) 列表 。 你 可 以 在 整个 英 联 邦 使 用 相同 的 英语 文本 ; 但 是 如 果 你 想 要 描述 一 种 动物 〈 使 用 英 联邦 英语 的 一 些 地 
区 对 一 些 动物 很 敏感 ) ， 或 者 以 首都 为 中 心 制 作 一 张 地 图 ， 那 么 New Zealand 和 India 之 间 的 差别 是 很 明显 的 ， 即 使 它们 都 视 公司 


不 论 通 过 哪 种 方法 ， 选 择 French(fn。 


Xcode 会 展示 一 个 清单 ， 里 面 列举 了 它 在 Base 目 录 中 找到 的 所 有 可 以 本 地 化 的 文件 ， 见 图 21.5。 你 可 以 不 勾 选 任何 你 不 想 
市 到 新 语言 环境 中 的 文件 ， 但 是 这 个 例子 中 我 们 想 要 所 有 的 文件 都 本 地 化 .。 


Choose files and reference language to create French localization 


Resource File Reference Language File Types 
J Main.storyboard Base > Localizable Strings 二 
Credits.rtf Base . 


Cancel 





图 21.5” 当 你 选择 法 语 本 地 化 时 ，Xcode 会 展示 它 在 lproj 目 录 中 发 现 的 资源 ， 以 及 如 何 生 成 本 地 化 资源 的 建议 


第 二 列 ，Reference Language 展 示 了 法 语 本 地 化 工作 将 会 以 哪个 文件 版 本 为 基础 。 这 些 都 是 用 于 扫 摘 字符 串 的 Interface 
Builder 的 资源 ， 或 者 用 来 翻译 的 文件 。 如 果 Mac Passer Rating 已 经 开发 了 一 系列 更 复杂 的 资源 ， 那 么 分 别 以 下 面 两 个 布局 为 
基础 的 新 语言 环境 的 主 storyboard 会 有 不 同 : 一 个 是 为 德语 设计 的 宽 布 局 ， 一 个 是 为 简体 中 文 设 计 的 紧凑 布局 。 但 是 我 们 刚刚 
开始 ， 每 个 文件 只 有 一 种 版 本 ， 所 以 这 一 列 的 弹出 菜单 只 有 一 个 选择 。 


第 三 列 ，File Types 让 你 选择 本 地 化 的 资源 将 要 采取 的 形式 。 特 别 的 ， 对 于 lnterface Builder 布 局 ， 你 可 以 选择 
LocalizableStrings 文 件 (默认 的 ) ; 或 者 Interface Builder document type， 对 “参考 ”布局 的 完整 复制 |。 


单 击 Finish。 明 显 的 变化 就 是 现在 Localizations 表 中 多 了 一 行 French。 而 真正 的 变化 在 Project 导 航 器 中 。 在 项 目 导航 器 最 
底部 的 搜索 区 栏 中 输入 fr， 你 将 会 看 到 一 些 文件 不 再 是 “文件 ”了 ， 而 是 有 提示 三 角形 的 分 组 。 每 个 分 组 包含 有 某 种 标 
记 “” (French) ”的 资源 。Credits.rtf 只 是 简单 的 复制 但 是 附加 了 一 个 标签 ; 附加 在 Main.storyboard 里 的 是 一 个 .strings 文 
件 ， 如 图 21.6 所 示 。 


2 targets, OS X SDK 10.10 
Mac Passer Rating 


Main.storyboard 


Main.strings (French) 
¥ | Supporting Files 
V « Credits.rtf 
< Credits.rtf (French) 





图 21.6， 当 添加 了 “法 语 ” 本 地 化 后 ， 本 地 化 的 资源 会 使 用 在 源 文件 上 修改 的 过 的 资源 ， 或 者 完全 替换 的 资源 


21.4.2 ABA: Credits.rtf 





让 我 们 先 从 简单 的 开始 ， 直 接 蔡 换 Credits.rtf 文 件 中 的 内 容 。 我 正在 使 用 的 文件 一 一 通常 来 源 于 应 用 模板 一 一 其 中 包含 一 些 
简单 幽默 的 关于 作者 信息 的 列表 (例如 ，With special thanks to: Mom) ， 见 图 21.7。 简 洁 和 幽默 是 美德 ， 所 以 我 就 直接 翻 


eS. 





Mac Passer Rating 


Version 1.0 (1) 





Engineering: 
Some people 


Human Interface Design: 
Some other people 


Testing: 
Hopefully not nobody 





umentation: 
Copyright © 2014 Fritz Anderson. All rights reserved. 





图 21.7 ”如 果 你 没有 提供 About 窗 口 ， 那 么 AppKit 会 为 你 的 应 用 生成 一 个 About 窗 口 。 如 果 有 Ctedits:ttf 文 件 ， 它 会 以 可 滚动 的 形式 


显示 在 窗口 的 中 间 


在 Project navigator 中 选择 Credits.rtf。 可 以 取 Base 版 本 (市 有 ”(Base) ”标签 ) 或 包 合 它 的 文件 (有 提示 三 角形 
的 ) ， 它 会 给 你 提供 英文 形式 的 参考 版 本 。 在 这 里 同步 很 重要 一 一 法 语 版 本 以 同样 的 内 容 开 始 ， 如 果 我 们 正 处 理 错误 的 版 本 会 





很 容易 友 现 。 
Xcode 有 一 个 RTF 编 辑 器 ， 所 以 作者 信息 在 编辑 器 上 呈现 的 方式 与 它们 在 About box 上 的 相同 ( 它 是 标准 的 AppKit 语 文本 编 
辑 器 ， 如 果 你 想 拥有 一 个 自己 的 ， 那 么 大 概 需 要 30 行 代码 ) 。 看 跳 转 栏 ， 你 会 看 到 项 目的 文件 级 数 ， 单 击 提示 三 角形 找到 


Credits.rtf 组 ， 它 的 下 面 束 是 Credits.rtf (Base) 。 
最 后 一 个 segment 会 让 你 在 多 个 本 地 化 本 件 之 间 跳 转 ， 你 可 以 在 工具 栏 的 这 个 segment 中 跳 转 到 其 他 本 地 化 文件 中 。 


每 个 版 本 文件 对 应 的 File 查 看 器 中 都 包含 一 个 普通 的 Localization 表 ， 里 面 列 出 的 项 目 涉及 的 所 有 地 区 。 你 可 以 通过 不 勾 选 
表格 中 的 某 个 地 区 来 移 除 该 文件 针对 这 个 地 区 的 本 地 化 。 或 者 ， 如 果 查 看 文件 的 其 他 版 本 ， 你 可 以 通过 在 表格 中 多 选 某 个 区 域 来 
添加 针对 这 个 地 区 的 本 地 化 版 本 ， 见 图 21.8。 








identity and Type 
Name Credits. rtf 
Type Default - Rich Text Format kd 





Location Ralative to Grout 
fr.lprojCredits.rtf 

Full Path /Users/fritza/Dropbox/Book/ 
X6StF/Sample Code/Advance 
work - Mac/Mac Passer 
Rating/fr.lproj/Credits.rtf 








» English 
>» French 
Target Membership 
©) © Mac Passer Rating 
| |Mac Passer RatingTests 












Source Control Show 


图 21.8 ”Credits.ttf 文 件 对 应 的 File 查 看 器 包含 一 个 Localization 表 格 ， 它 能 控制 文件 是 否 针 对 菜 个 地 区 做 本 地 化 


再 看 一 看 Finder 中 的 项 目 文 件 目录 树 。en.lproj 和 Base.lproj 中 已 经 加 入 了 fr.lproj。 在 Base 文 件 中 的 Main.storyboard 已 经 


与 French 文 件 夹 中 的 Main.strings 匹 配 。 


Credits.rtf 文 件 呢 ? 尽管 它 开始 是 在 Base.lproj 中 ，Xcode 把 它 法 语 译文 副本 放 在 了 project 目 录 的 fr.lproj 文 件 夹 中 ， 而 不 是 
Mac PasserRating 的 目标 文件 。 这 也 许 是 个 bug， 你 不 会 在 未 来 的 版 本 中 见 到 。 但 Xcode 仍然 能 找到 这 个 文件 ， 并 且 把 它 包 合 
在 应 用 包 中 它 应 该 在 的 地 方 。 


Xcode 本 地 化 的 思想 就 是 : 给 你 一 个 资源 (作为 参考 版 本 ) 的 副本 ， 让 你 照 着 语言 环境 的 要 求 来 编辑 。 和 直截了当 地 说 ， 如 果 
你 能 想象 项 目 中 的 两 个 文件 也 许可 以 通过 某 种 方法 互相 联系 ，Apple 会 说 “这 里 有 一 个 可 以 使 用 的 辅助 工具 ”。 选择 
Credits.rtf， 激 活 Assistant editor， 在 跳 转 栏 的 根部 选择 Localizations。 


如 果 不 只 一 个 本 地 化 ， 你 可 以 通过 跳 转 栏 右 侧 的 箭头 在 它们 之 间 切 换 ， 或 者 通过 按 ^ 碟 一 或 一 快捷 键 。 但 是 本 次 只 有 一 个 选 
$, WEE (A) 编辑 器 上 显示 的 应 该 是 灵 语 版 本 ， 在 Assistant (A) 编辑 器 显示 的 是 法 语 版 本 。 


替换 法 语文 件 中 每 一 行 的 内 容 如 下 : 
+ Les ing enieurs:Certains gens 
- Conception d’ interface humaine:D’ autres gens 
- Test:On esp ere que ce n est pas personne 
- Documentation:N’ importe qui 


- Nous remercions particuli erement: Maman 


测试 本 地 化 最 有 效 的 方法 就 是 调整 System Preferences 的 语言 偏好 ， 重 启 Mac Passer Rating, @4About box 是 否 包 含 最 新 
的 文本 。 不 过 这 也 会 让 你 打开 的 其 他 应 用 使 用 法 语 版 本 ， 直 到 你 把 语言 偏好 重新 设置 回来 。 如 果 不 改 回 来 不 方便 ， 除 非 你 想 在 法 
语 环境 下 工作 。 


9 注意 当 你 编辑 InfoPlist.strings 来 本 地 化 菜 些 内 容 ， 比 如 应 用 显示 的 名 字 时 候 ， 有 必要 更 改 系 统 范围 的 语言 偏好 。 你 将 不 
得 不 构建 App， 改 变 语言 偏好 ， 使 用 量 EEscape 快 捷 键 重新 启动 Finder。 


你 可 以 使 用 Scheme editor 为 一 个 Xcode 的 target 更 改 语言 偏好 (Product 一 Scheme 一 Edit Scheme..., Æ<) 。 选 择 Run 
行为 以 及 Options 选 项 卡 。Application Language 弹 出 框 会 包含 这 个 app 本 地 化 的 所 有 语言 ， 并 加 上 以 下 3 个 : 


System Language， 它 使 用 System Prefetences 面 板 中 Languapge&Region 的 优先 列表 。 
- Double Length Pseudolanguage， 它 将 Baselocalization 中 的 所 有 字符 串 绘制 了 两 遍 ， 用 来 适应 布局 。 


- Right to Left Pseudolanguage， 它 使 得 Auto Layout 布 局 方案 会 假设 有 一 个 从 右 到 左 布 局 的 语言 ， 例 如 布 伯 来 语 或 者 阿拉 伯 


` 这 就 是 为 什么 水 平 约束 被 称 为 leading 和 trailing 边 缘 ， 而 不 是 left 和 right (即使 标签 是 Left 或 者 Ripght， 你 通常 获得 的 也 是 
leading-and-trailing 约 来 ) 。 你 可 以 在 Interface Builder 中 选择 它 来 请 求 一 个 显 式 的 left-or-tight 约 来 ， 并 且 Attributes 查 看 器 中 的 每 一 项 


Ak A 4) Respect language ditrection， 边 缘 才 会 成 为 Left 和 Right。 


切换 到 法 语 ， 然 后 运行 App。 并 没有 多 少 变 化 ， 我 们 没有 对 荣 单 和 窗口 内 容 做 任何 处 理 ， 尽 舍 系 统 提供 的 字符 串 : 像 数字 和 
日 期 格式 还 有 自动 生成 的 菜单 标题 已 经 切换 为 了 法 语 。 选 择 MacPasser Rating 一 Apropos de Mac Passer Rating。 这 里 的 作者 


信息 曾经 是 英文 ， 现 在 是 法 语 (图 21.9) 。 这 是 一 个 开始 。 








Mac Passer Rating 


Version 1.6 (1) 
Les ingénieurs: 
wertains gens 


Conception d interface humaine: 
D'autres gens 


Test; 
On espèrs gue ce n'est pas personne 
Documentation: 
Copyright © 20174 Fritz Anderson. All rights reserved, 


图 21.9 ”提供 一 个 法 语 版 本 的 Credits.rtf， 并 且 在 Scheme editot 中 将 Application Language 设 置 为 法 语 ， 这 会 让 AppKit 在 上 自动 生成 的 
About 对 话 框 中 使 用 本 地 化 后 的 版 本 


21.4.3 ”本 地 化 Main.storyboard 


在 Xcode 5 和 OS XMavericks(10.9) 之 前 ， 很 难 介 绍 这 部 分 内 容 。 本 地 化 一 个 XIB (storyboards 还 不 可 用 ) 文件 需要 使 用 命 
令 行 分 析 原 始 资源 ， 提 取出 所 有 的 字符 串 ， 生 成 一 个 .strings 文 件 ， 然 后 将 原 资源 与 翻译 之 后 的 字符 串 合 并 ， 本 地 化 XIB 会 为 你 终 
生 维 护 。 


现在 情况 变 得 好 多 了 。 当 你 选择 本 地 化 一 个 Interface Builder 资 源 的 时 候 ，Xcode 负 责 提取 字符 串 ， 当 载 入 资源 和 蔡 换 译文 
时 ，AppKit 会 读 取 . K 在 Project 导 航 器 中 选择 MPRGameViewController.xib。 与 以 前 一 样 ， 它 展示 的 是 一 个 分 组 ， 
单 击 它 展示 主 版 本 一 一 在 这 个 例子 中 ， 仪 有 的 XIB 副 本 在 Baselocalization 中 ， 并 且 如 果 你 在 的 Assistant editor 的 跳 转 栏 中 选择 
Localizations， 融 不 仅 会 看 到 XIB 的 副本 ， 还 会 看 到 提取 出 的 .strings 文 件 。 


如 下 所 示 ， 这 个 文件 只 是 基础 字符 串 的 重新 声明 。 


/x Class = "NSTableColumn"; headerCell.title = "When"; ... */ 
"VW8C-L2-cIW.headerCell.title" = "When"; 

/x Class = "NSMenulItem"; title = "Clear Menu"; ... «/ 
"VNY-rz-j42.title" = "Clear Menu"; 

/x Class = "NSTableColumn"; headerCell.title = "Us": ... «/ 
"voc-ie-bq).headerCell.title" = "Us"; 

/* Class = "NSMenuItem"; title = "Help"; ... */ 
"wor-3q-Mcd.title" = "Help"; 

/* Class = "NSMenuItem"; title = "Copy"; ... */ 
"x3v-GG-iWU.title" = "Copy"; 

/x Class = "NSTableColumm": headerCell.title = "Yards": ... */ 
"xIc-Wa-j]KO.headerCell.title" = "Yards"; 


它 是 一 系列 键 值 对 。 这 些 键 是 Interface Builder 中 元 素 的 内 部 标识 符 ， 每 个 标志 符 都 附 上 了 类 和 原来 内 容 的 注释 。 编 辑 这 些 
字符 串 获得 一 个 法 语 演 染 的 标签 。 它 们 在 fr.lproj 目 录 中 ，AppKit 通 过 名 字 与 Base.I|proj 中 的 storyboard 相 匹配 ， 然 后 把 它们 合 
并 


Ose 你 可 能 不 会 这 么 做 ,但 是 如 果 你 不 打算 本 地 化 的 话 ， 就 不 要 给 .strings 文 件 命 名 与 Interface Buildet 文 档 一 样 的 名 字 。 


技术 问题 很 简单 ， 尽 管 在 大 型 项 目 中 有 些 见 繁 : 只 要 用 Touch'es 代 苦 Touchdowns， 用 Tent'ees 代 蔡 Attempts， 等 等 。 根 
据 我 的 经 验 ， 让 某 个 领域 的 专家 翻译 出 现 的 社会 问题 才 是 难 的 部 分 。 


前 面 那 部 分 摘录 的 内 容 束 会 变 


/* Class = "NSTableColumn"; headerCell.title = "When": ... */ 
"Ww8C-L2-cIW.headerCell.title" = "Quand"; 

/x Class = "NSMenulItem"; title = "Clear Menu"; ... */ 
"YVNY-rz-j342.title" = "Effacer le menu"; 

/x Class = "NSTableColumn"; headerCell.title = "Us"; ... */ 
"voc-1ie-bqj.headerCell.title" = "Nous"; 

/x Class = "NSMenulItem"; title = "Help"; ... */ 
"wer-3q-Mcd.title" = "Aider"; 

/x Class = "NSMenuItem"; title = "Copy"; ... */ 
"x3v-GG-iWU.title" = "Copier"; 

/x Class = "NSTableColumn"; headerCell.title = "Yards"; ... */ 


"xIc-Wa-j]KO.headerCell.title" = "Verges"; 


与 Mac Passer Rating 对 应 的 翻译 为 : 


AppKit 没 有 给 出 标准 荣 单项 的 翻译 ， 如 : Cut 或 者 Quit。 你 必须 要 在 .strings 文 件 中 手动 填写 。 


Touchdowns Touches 
Attempts Tentees 
Yards Verges 
Interceptions Interceptees 
Completions Captees 
Rating Efficacite 
Quarterback Quart 


Fill with Test Data | Remplissez avec les donnees de test 


Apple 这 里 会 给 你 一 点 帮助 。 它 有 一 个 本 地 化 支持 的 页 面 : https://developer.apple.com/internationalization/， 在 这 里 
你 可 以 下 载 工具 (ARARA) 。 在 Downloads 部 分 查看 AppleGlot。AppleGlot 工 具 本 身 没有 什么 吸引 力 ， 但 真正 有 价值 
的 内 容 是 其 中 包含 的 词汇 表 ，Apple 使 用 它 来 翻译 应 用 程序 和 系统 软件 。 它 有 多 种 语言 ， 法 语 也 在 其 中 。 我 融 不 用 菜单 和 其 他 项 
的 完整 翻译 来 占据 更 多 篇 幅 了 ， 在 示例 代码 中 查看 fr.Ipro/Main.strings。 


现在 你 已 经 完成 了 翻译 ， 运 行 上 应用。 图 21.10 展 示 了 3 种 本 地 化 方式 下 的 League 文 档 窗 口 。 上 面 的 窗口 使 用 了 
doubledpseudolanguage。 它 正如 你 希望 看 到 的 那样 ， 但 是 如 果 你 缩小 整个 窗口 ，team detail 视 图 中 的 标签 不 会 让 自己 变 得 
太 窄 而 不 能 完整 地 展现 内 容 。 你 应 该 能 从 中 学 习 到 一 些 内 容 。 


Augusta Autocrats 
Boise Bearcats 


Untitled Untitled 一 Edited E 


gitec 


Passers for the {value1}@ Passers for the Augusta Autocrats 


Des Moines Desperadoes Name Name Rating R... Att Att Comp... Yards... TDs TDs INTs |... 

Fremont Firebugs {value1}@ {value2}@ John Tyler 81.4 163 67 64 14 0 

Glendale Centers {value1}@ {val...@ Tom Wilson 62.6 3,521 1,548 13,568 83 0 

Grand Rapids Gamers {value1}@ {val...erbert Hoover 64.6 48 23 260 0 0 

Huntington Beach Harriers 

Mobile Misfits 

Modesto Misanthropes 

Montgomery Music Games played by {value1}@ Games played by John Tyler 

Richmond Roustabouts Us Us Them Them When When Ratin.. 

San Bernardino Stalkers {value1}@ - {v...utocrats- 14 {value1}@ - {v...s Gamers -10 24 Mar 2014 59.4 

Shreveport Seamen {value1}@ - {v...Autocrats -8 {value1}@ - {v...Harriers - 34 31 Mar 2014 60.4 

Spokane Stallions {value1}@ - {v...Autocrats -9 {value1}@ - {v...s Gamers -34 23 Mar 2015 64.6 

Tacoma Touchdown-Scorers {value1}@ - {v...utocrats - 13 {value1}@ - {v...nthropes -37 20 Apr 2015 101.0 

Yonkers Yellowjackets {value1}@ - {v...utocrats -26 {value1}@ - {v...Firebugs -14 27 Apr2015 78.6 
{value1}@ - {v...Autocrats-9 {value1}@ - {v...Stallions - 20 11 May 2015 95.8 
[valia1l@ -Iv itocrats - 1? {valal1l®@ -lv wiackets - 27 25 Mav 2N15 A4 R 


Untitled — Edited 
Augusta Autocrats 
Boise Bearcats 
Yards TDs Des Moines Desperadoes 
641 14 0 Fremont Firebugs 
13,568 83 0 Glendale Centers 
260 0 0 Grand Rapids Gamers 
Huntington Beach Harriers 
Mobile Misfits 
Modesto Misanthropes 
Montgomery Music 
Richmond Roustabouts 
San Bernardino Stalkers 
Shreveport Seamen 
Spokane Stallions 
Tacoma Touchdown-Scorers 
Yonkers Yellowjackets 


Passers for the Augusta Autocrats 


Name Rating Att INTs 
John Tyler 81.4 163 67 
Tom Wilson 62.6 3,521 1,548 


Herbert Hoover 64.6 48 23 


Comp 


Games played by John Tyler 


Us Them When 
Augusta Autocrats - 14 Grand Rapids Gamers - 10 24 Mar 2014 
Augusta Autocrats - 8 Huntington Beach Harriers - 34 31 Mar 2014 
Augusta Autocrats - 9 Grand Rapids Gamers - 34 23 Mar 2015 
Augusta Autocrats- 13 Modesto Misanthropes - 37 20 Apr 2015 
Augusta Autocrats - 26 Fremont Firebugs - 14 27 Apr 2015 
Augusta Autocrats - 9 Spokane Stallions - 20 11 May 2015 

‘rate - 1 nk 


Rating 
59.4 
60.4 
64.6 
101.0 
78.6 
95.8 


Kats ~ i l - yi Ma 





AALIS ars Yallowis 


> Fy... Y 
VWIVUUIIC 


© Sans titre — 
Augusta Autocrats 


Boise Bearcats 


Passers for the Augusta Autocrats 


Des Moines Desperadoes Nom 
Fremont Firebugs John Tyler 
Glendale Centers Tom Wilson 


Grand Rapids Gamers 
Huntington Beach Harriers 
Mobile Misfits 

Modesto Misanthropes 
Montgomery Music 
Richmond Roustabouts 
San Bernardino Stalkers 
Shreveport Seamen 
Spokane Stallions 

Tacoma Touchdown-Scorers 
Yonkers Yellowjackets 


Herbert Hoover 


Nous 

Augusta Autocrats - 14 
Augusta Autocrats - 8 
Augusta Autocrats - 9 
Augusta Autocrats - 13 
Augusta Autocrats - 26 


Augusta Autocrats - 9 
Annusta Autocrats - 12 


图 21.10 Mac Passer Rating 的 League 文 档 窗 只 ， 在 Scheme editor 设 置 的 3 种 应 用 语言 下 运行 。 
(P) Right to Left Pseudolanguage 改 变 了 布局 ， 把 源 列表 放 在 了 左边 ， 并 且 让 大 部 


Pseudolanguage 复 制 了 布局 中 的 每 一 个 字符 串 。 


Games played by John Tyler 


Efficacité Tent Capt Verges Touch Int 

81,4 163 67 641 14 0 

62,6 3 521 1548 13 568 83 0 

64,6 48 23 260 0 0 
lis Quand Effica... 
Grand Rapids Gamers - 10 24 mars 2014 59,4 
Huntington Beach Harriers-34 31 mars 2014 60,4 
Grand Rapids Gamers - 34 23 mars 2015 64,6 
Modesto Misanthropes - 37 20 avr. 2015 101,0 
Fremont Firebugs - 14 27 avr. 2015 78,6 
Spokane Stallions - 20 11 mai 2015 95,8 
Yonkers Yallowiackats - 27 25 mai 2015 RAAR 


(上 ) Double Length 


分 数据 重新 对 齐 。 (下 ) Prench 采 用 了 本 地 化 后 的 格式 和 字符 串 一 一 除了 传 球 手 和 game 表 格 上 方 的 标签 


第 二 个 窗口 及 用 了 right-to-left pseudolanguage。 采 用 默认 的 leading/trailing 约 束 吸 引 了 我 们 的 注意 力 ， 但 是 数字 和 日 
期 列 的 对 齐 方式 更 让 我 们 天 注 。 


第 三 个 是 French。 这 里 看 不 出 来 ， 但 是 菜单 是 被 翻译 过 了 的 。 日 期 和 数字 格式 是 对 的 ， 列 标题 也 是 对 的 ， 名 字 应 当 不 用 翻 
译 。 现 在 的 问题 是 传 球 手 和 game 表 格 的 标签 ， 它 们 仍然 是 英语 。 


如 果 你 回 到 Scheme editor， 勾 选 Localization Debugging: Shownon-localized strings 并 再 次 运行 ; 所 有 还 未 本 地 化 的 
字符 串 将 会 以 大 写 的 形式 展现 。 标 釜 (以 及 表格 中 的 模式 ) 都 还 没有 本 地 化 。 我 之 前 本 地 化 了 它们 ， 再 检查 一 迄 ， 友 现 它 们 仍然 


是 Base localization 中 的 格式 。 


这 是 Yosemite 版 本 中 的 一 个 bug。 我 希望 当 你 阅读 本 书 的 时 候 ， 这 个 问题 已 经 修正 了 。 但 是 对 于 这 本 书 来 襄 ， 这 是 一 个 机 
会 。game-detail 弹 出 窗口 中 也 是 这 样 。Game 中 的 日 期 都 是 正确 的 French， 但 是 stat-view 标 签 仍然 是 英语 ， 因 为 
MacStatView 不 是 一 个 可 本 地 化 的 控件 。 


这 给 了 我 们 机 会 去 探索 另外 两 种 本 地 化 策略 。 


2144 ”本 地 化 贷 源 


AppkKit 不 会 帮 你 本 地 化 MacStatViews， 所 以 你 需要 上 自己 完成 它 的 本 地 化 工作 。 但 它 并 没有 完全 让 你 独立 完成 


任何 资源 都 是 可 以 被 本 地 化 的 。 当 应 用 向 NSBundle.mainBundle0 请 求 一 个 文件 路 径 的 时 候 ，NSBundle 首 先 在 App 
的 .lproj 目 录 中 和 寻找。 如果 偏 好 语言 设置 的 是 法 语 ， 并 且 想 要 寻找 的 文件 就 在 fr.lproj 文 件 夹 中 ， 那 么 NSBundle 就 会 返回 指向 那 
个 文件 夹 的 路 径 。 如 果 失 败 ， 它 会 继续 在 用 户 偏好 的 语言 列表 中 寻找 ;然后 是 Base.lproj; 最 后 到 应 用 包 的 公共 Resources 目 录 
中 寻找 。 


所 以 我 们 会 为 stat views 添 加 一 个 英语 的 标签 列表 ， 然 后 再 对 它们 做 法 语 本 地 化 操作 。 这 个 标签 列表 将 采用 property 
list(.plist) 文 件 的 格式 。 第 23 章 中 会 深入 阐述 这 个 话题 ， 但 是 现在 ， 只 需要 从 示例 代码 取出 stat-labels.plist 文 件 即 可 。 它 已 经 被 
添加 到 了 Project 导 航 器 中 ; 你 可 以 直接 单 击 它 看 看 是 什么 。 


表 21.1 显 示 的 是 英语 译文 ， 区 别 很 小 。 


表 21.1 Storyboard 上 的 Stat View 标签 和 英语 环境 中 展示 出 来 的 标签 之 间 的 英语 映射 没什么 区 别 


Attempts Attempts Touchdowns Touchdowns 
Completions Completions Interceptions Interceptions 
Yards Yards | | 


如 果 你 有 空 ， 你 可 以 在 Resources 下 方 的 新 文件 助手 里 找到 Property List 模 板 。 将 其 命名 为 stat-labels.plist， 并 把 它 放 到 
Base.lproj 目 录 中 。 使 根 元 素 成 为 一 个 词典 ， 按 照 展 示 出 来 样子 填 入 键 和 值 (此 技术 的 详情 见 第 23 章 ) 。 





接 下 来 ， 勾 选 Localizations 下 的 French 框 ， 使 用 File 查 看 器 来 添加 一 个 法 语 本 地 化 。 使 用 Assistant 编 辑 器 中 的 
Localizations 视 图 ， 或 者 直接 在 Project 导 航 器 中 单 击 (French) 版 本 ， 向 下 面 这 样 编辑 法 语 版 本 (表格 21.2) 。 


表格 21.2 stat view 标 签 的 法 语 映射 有 了 一 些 区 别 


Attempts Tentees 
Completions Captees 
Yards Verges 
Touchdowns Touches 
Interceptions Interceptees 


然后 ， 在 弹出 窗口 加 载 的 时 候 ， 编 辑 stat views 的 名 称 : 


override func viewDidLoad() { 
super.viewDidLoad () 


// Read the home-grown localization dictionary for the stat views 
let mainBundle = NSBundle.mainBundle() 
if let statLabelURL:NSURL = mainBundle.URLForResource ( 
"Sstat-labels", withExtension: "plist") { 
if let labelMap = NSDictionary(contentsOfURL: statLabelURL) 
as? [String:String] { 
// Use the IB-provided names to look up the localized ones. 
for statView in [attemptsView, yardsView, touchdownsView, 
completionsView, interceptionsView] { 
statView.name = labelMap[statView.name] ! 


} 
} 
// Fill in the numbers. 


loadStatViews () 


在 英语 和 法 语 环境 下 运行 Mac Passer Rating， 就 会 看 到 标签 适应 了 当前 的 语言 环境 一 一 
URLForResource (,withExtension:) 将 stat-labels.plist 的 URL 措 和 同 了 合适 的 .lproj 中 的 文件 。 


21.4.5 ”本 地 化 程序 字符 串 


继续 格式 化 Passers for 和 Games played 标 签 最 多 融 是 麻烦 点 。 有 建立 和 修改 绑 定 的 AP1， 但 是 大 部 分 人 因为 某 个 原因 拒绝 
使 用 。 这 就 给 了 我 们 机 会 来 看 本 地 化 的 第 三 种 案例 : 代码 中 生成 字符 串 。 


把 switch 语 名 或 者 每 种 语言 的 格式 化 对 象 或 者 其 他 零散 的 本 地 管理 的 添加 到 代码 中 ， 是 AppKit 一 直 避 免 帮 生 的 事 。 现 在 有 
了 用 处 : 你 的 代码 通过 key 来 指向 可 本 地 化 的 字符 串 ， 用 于 本 地 化 的 字符 串 会 在 运行 的 时 候 获 取 。 


整个 过 程 从 使 用 字符 串 的 代码 开始 。 我 们 让 Team 和 Passer 自 己 生成 标签 对 应 的 字符 串 。 这 是 TeamDetailController 特 有 的 
一 个 需求 ， 所 以 把 代码 放 到 TeamDetailController.swift 的 extensions 中 很 有 意义 : 


extension 
Passer { 
func passerGameHeader() -> String { 
let format = NSLocalizedString("Games played by %@", 
comment: "Format string for the label over the games table") 
let retval = NSString(format: format, fullName) 
return retval as! String 


extension 
Team { 
func teamPasserHeader() -> String { 
let format = NSLocalizedString("Passers for the %@", 
comment: "Format string for the label over the passers table") 


let retval = NSString(format: format, teamName) 
return retval as! String 


在 使 用 字符 串 的 地 方 ， 你 需要 调用 NSLocalizedstring (_comment:) 。 第 一 个 参数 用 于 查找 本 地 化 的 字符 串 版 本 的 key; 
第 二 个 参数 (comment:) 提供 了 上 下 文 翻译 器 ， 它 可 以 用 于 确定 特殊 用 途 的 正确 语句 。 


Ose do EBA, NSLocalizedString (-,comment:) 实际 上 是 NSLocalizedSttingfull 的 一 个 调用 ， 有 3 个 缺 省 的 参数 ， 所 以 搜 
索 发 生 在 主 包 搜索 路 径 的 Localizable.strings 中 。 在 Objective-C 中 ， 可 选 参 数 是 在 C 预 处 理 宏 中 通过 封装 大 的 函数 调用 处 理 的 。 


现在 你 需要 的 歹 是 一 个 字符 串 文 件 一 一 Localizable.strings， 使 每 一 个 .lproj 中 都 要 包含 这 个 文件 ， 它 可 以 在 运行 时 填写 正 
确 的 字符 串 。 有 两 种 万 法 来 做 这 件 事 。 


21.4.6 genstrings 


第 一 种 方法 是 在 命令 行 中 运行 genstrings 命 令 。 很 简单 ， 下 面 就 是 你 要 做 的 内 容 : 


$ # Focus on the target directory 

$ cd 'Desktop/Mac Passer Rating/Mac Passer Rating/' 

$ # This is the directory containing your source files. 
$ genstrings *.swift 

$ 1s 


ee E N 
$ 
新 的 Localizable.strings 文 件 中 有 一 个 词典 ， 包 含 了 NSLocalizedString(,comment:) 所 有 的 调用 。 还 有 key 和 与 key 字 竺 串 


相对 应 的 字符 串 ， 你 写 的 注释 会 出 现在 注释 行 。 


/* Format string for the label over the games table «/ 
"Games played by %@" = "Games played by %@"; 


/* Format string for the label over the games table */ 


"Passers for the %@" = "Passers for the %@"; 
这 是 Base 版 本 。 把 它 添加 到 项 目 中 ， 在 编辑 器 中 显示 它 ， 并 且 使 用 File 碍 看 器 来 添加 一 个 French 本 地 化 : 当 你 单 击 


Localizehttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 按 钮 时 ，Xcode 告 诉 你 需要 把 这 个 文件 移动 到 一 


个 .|proj 文 件 夹 中 ， 并 且 会 询问 你 放 到 哪 一 个 文件 夹 中 。 把 它 移动 到 Base 中 ， 现 在 本 地 化 语言 的 表格 已 经 显示 出 来 ; 单 击 
French， 之 后 你 就 知道 怎么 做 了 。 


/* Format string for the label over the games table */ 
"Games played by %@" = "Jeux de %@"; 


/* Format string for the label over the games table */ 
"Passers for the %@" = "Quart-arriéres des %@"; 


所 剩 下 的 就 是 终止 标签 的 Display Pattern 绑 定 ， 用 普通 的 Value 绑 定 来 代替 ， 这 样 就 会 绕 过 这 个 bug。 对 每 一 个 标签 ， 去 除 


pattern 绑 定 ， 勾 选 Value 绑 定 。 
- 表格 上 方 的 passet 标 签 设置 为 Team Object,selection,teamPasserHeader. 
:下方 的 game 标 签 设 置 为 Passet Array,selection,passerGameHeader. 
重要 的 事 : pattern 绑 定 失 败 的 本 地 化 仍然 在 Main.strings 中 ， 编 辑 Main.strings 删 除 它们 或 把 它们 注释 掉 。 


再 一 次 运行 Mac Passer Rating， 标 签 束 会 显示 为 正确 的 语言 。 
21.4.7 xliff 文 件 


我 同 你 介绍 这 么 多 是 因为 ， 如 果 不 介绍 Cocoa 框 架 使 用 了 很 多 年 (现在 仍 在 使 用 ) 的 本 地 化 方法 ， 你 将 无 法 分 析 本 地 化 的 沅 
程 并 处 理 这 些 偏僻 的 案例 。 你 必须 了 解 这 些 技巧 ， 但 不 是 必须 使 用 它们 。 


Xcode 6 引入 了 用 于 交换 翻译 词典 的 .xliff XML schema 的 支持 。 在 你 本 地 化 的 任何 时 候 ， 可 以 打开 Project editor (Project 
导航 器 ， 顶 部 的 一 项 ， 选 择 项 目 本 身 ) ， 然 后 选择 Editor 一 Export 
forLocalizationhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ ebook/uncompressed/15555/OEBPS/Text/...Xcode 会 问 你 是 想 仅 导出 开发 字符 串 (就 是 在 
Base、lnfo.plist 和 代码 中 的 字符 串 ) ， 还 是 也 导出 添加 了 本 地 化 的 字符 串 。 选 择 一 个 ， 然 后 提供 导出 文件 名 ， 最 后 将 它 保 仔 人 在 
磁盘 上 。 


最 终 的 结果 就 是 一 个 你 命名 的 目录 ， 其 中 包含 所 有 语言 环境 的 .xliff 义 件 (省 略 了 一 些 并 添加 了 换行 符 ) 。 


LLELE wv 

<file original="Mac Passer Rating/Base.lproj/Main.storyboard" 
source-language="en" datatype="plaintext" target-language="fr"> 
<header> 


</header> 
<body> 
<trans-unit id="aTl-1lu-JFS.title"> 


<source>Print...</source> 
<target>Imprimer...</target> 


<note>Class = "NSMenuItem"; title = "Print..."...</note> 
</trans-unit> 
<trans-unit id="aUF-d1-5bR.title"> 

<source>Window</source> 

<target>Fenétre</target> 

<note>Class = "NSMenuItem"; title = "Window"...</note> 
</trans-unit> 
<trans-unit id="bib-Uj-vzu.title"> 

<source>File</source> 

<target>Fichier</target> 

<note>Class = "NSMenu"; title = "File"...</note> 
</trans-unit> 


</body> 
</file> 
</x1 iit 


最 顶层 的 <file> 元 素 确 认 每 一 个 原文 件 ; 有 一 个 很 好 的 特性 束 是 ， 即 使 你 用 .strings 文 件 代替 一 个 InterfaceBuilder 文 档 ， 译 
文 还 是 会 被 识别 成 XIB 或 者 storyboard， 而 不 是 .strings。 


字符 串 的 初始 内 容 会 被 标记 为 <source> 元 素 ， 可 以 将 译文 作为 <target> 元 素 ， 这 样 束 获 得 了 给 翻译 员 的 文件 。 当 她 翻译 元 
成 ， 融 可 以 把 这 个 文件 传 回来 ， 然 后 你 可 以 选择 
Editor—ImportLocalizationshttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.. R#GAMHAR. 


这 解决 了 .strings 文 件 的 一 个 大 问题 : 当 你 改变 一 个 storyboard 时 会 发 生 什 么 呢 ， 比 如 添加 一 个 场景 ,或 者 更 糟糕 一 点 ， 添 
加 和 删除 标签 或 控件 ?因为 这 些 改变 只 友 生 在 基础 语言 文件 中 ， 你 必须 保存 本 地 化 文件 的 副本 ， 从 storyboard 中 移 除 本 地 化 然 
后 再 添加 回去 。 生 成 的 .strings 文 件 仅 会 包含 区 语 语言 的 内 容 ， 然 后 你 需要 将 翻译 后 的 内 容 合 并 进去 。 


当 你 导出 一 个 .xliff， 你 就 得 到 了 一 系列 已 经 存在 的 译文 ， 以 及 base storyboard 的 结构 。 它 已 经 合并 过 ， 所 有 你 需要 做 的 就 
是 填写 缺漏 的 。 


21.4.8 其 他 


编辑 法 语 的 .strings 文 件 ， 像 往常 一 样 运行 Mac Passer Rating 检 验 你 的 工作 。 大 多 数字 符 串 都 是 英语 ， 但 如 果 你 查看 game 
的 弹出 窗口 ， 就 会 看 到 成 果 .…… 


— 除非 你 没 看 。.strings 文 件 提供 了 翻译 的 标签 都 已 经 被 应 用 用 数字 、 正 确 的 名 称 或 者 日 期 重 写 。 前 面 两 个 不 用 翻译 ， 日 期 
标签 依赖 于 OS X 提 供 的 系统 范围 的 日 期 格式 ， 你 的 系统 整体 上 设置 的 仍然 是 英语 格式 。 


Stat views 是 另 一 个 问题 : 它们 不 是 标准 的 AppKit 元 素 ， 所 以 AppKit 不 知道 如 何 将 .strings 文 件 应 用 在 它们 身上 。 你 必须 在 
代码 中 设置 它们 。 


21.5 ”本 地 化 系统 字符 串 


之 前 你 也 看 到 了 本 地 化 Main.storyboard 没 有 处 理应 用 的 菜单 (Mac Passer Rating) 。 同 样 还 有 其 他 缺陷 : 默认 的 About 
窗口 包含 英语 的 应 用 名 称 和 版 权 声 明 ; 如 果 你 用 Finder 查 看 个 法 语 本 地 化 中 的 MPR 图 标 ， 它 的 名 称 也 是 英语 ， 并 且 它 的 文档 也 


会 用 天 语 标记 。 


这 些 字 符 串 都 来 自 Info.plist， 我 会 在 22 章 以 及 23 章 中 介绍 。 在 一 个 包 路 径 下 (例如 一 个 .app 包 ) 只 有 一 个 Info.plist， 但 你 
可 以 通过 用 户 语言 环境 对 应 的 .lproj 目 录 中 的 .strings 文 件 来 改变 它 显 示 的 内 容 。 


本 地 化 Info.plist 就 像 本 地 化 其 他 资源 一 样 一 一 通过 添加 一 个 .strings 文 件 ， 在 此 例 中 就 是 InfoPlist.strings。 刚 开始 的 时 候 ， 
项 目 中 没有 这 个 文件 ， 因 为 唯一 的 本 地 语言 就 是 Base， 当 然 就 没有 本 地 化 。 当 你 添加 了 法 语 ， 还 是 没有 InfoPlist.strings， 因 为 


还 没有 翻译 。 


InfopPlist.strings 可 以 通过 两 种 类 型 的 Keys 选 择 要 本 地 化 的 字符 串 : 如 果 你 想 设 置 value 与 Info.plist 中 的 key 一 一 对 应 ， 那 融 
使 用 那个 keyf 作 为 翻译 的 key。 人 否则 ， 使 用 出 现在 基本 Info.plist 中 的 字符 串 。 


为 了 满足 Mac Passer Rating 的 需求 ， 首 先 你 必须 向 Info.plist 的 源 文件 中 添加 两 个 key。 在 Project 导 航 器 中 选中 那个 文件 ， 
并 且 添 加 两 行 : 


- Bundle display name (CFBundleDisplayName) 。 作 为 一 个 占 位 符 设 置 给 字符 串 ${PRODUCT NAME}; 实际 的 字符 串 会 从 本 
地 化 文件 中 拉 取 出 来 。 


- Application has localized display name(LSHasLocalizedDisplayName) 告 诉 Launch Services 和 Finder， 它 们 必须 花 额 外 的 精力 来 寻 
找 本 地 化 版 本 的 app 名 称 。 


接着 ， 处 理 Info.plist 中 keys 对 应 的 法 语 本 地 化 的 值 。 通 常 ， 你 会 在 fr.lproj 中 创建 一 个 InfoPlist.strings 文 件 ， 并 为 
CFBundleName (Quart-Efficacité) 、CFBundleDisplayName (也 是 Quart-Efficacite) ， 以 及 
NSHumanReadableCopyright (Copyrighthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/...Toutes droits reservees.) 填写 键 值 对 。 


注意 你 也 许 会 认为 可 以 用 File 查 看 器 添加 一 个 法 语 本 地 化 到 Info.plist 文 件 中 ， 就 像 你 之 前 对 Main.storyboard 所 做 一 样 ， 并 
且 得 到 一 个 InfoPlist.Strings 文 件 。 这 不 会 起 作用 : Xcode 遵循 处 理 其 他 资源 的 策略 ， 并 将 base Info.plist 复 制 到 ff.lproj 目 录 中 。 你 必 
须 目 己 创 建 InfoPlist.sttings 。 


以 下 惑 是 fr.Iproj/lnfopPlist.strings 需 要 包含 的 内 容 (一 些 长 的 字符 串 省 略 了 ， 并 添加 了 换行 符 ) : 


/x One-to-one values for Info.plist keys x*/ 
"NSHumanReadableCopyright" = 


"Copyright ... Toutes droits reservées."; 
"CFBundleDisplayName" = "Quart-Efficacité"; 
"CFBundleName" = "Quart-Efficacite"; 


/x The file-type string is inside an array, and a single plist key 
doesn't correspond to it. Use the untranslated value as the key: */ 
"League File" = "Fichier de Ligue"; 


测试 Info.plist 本 地 化 分 为 两 部 分 。 第 一 部 分 很 简单 : 运行 Mac Passer Rating 并 且 核 实 应 用 菜单 以 及 About 框 中 的 内 容 和 你 
期 待 的 一 样 。 


Finder 的 行为 棘手 一 些 ， 因 为 你 必须 在 System Preferences 的 Language&Text 面 板 中 设置 偏好 语言 ， 然 后 重新 局 动 
Finder， 它 才 会 获取 本 地 化 的 字符 串 。System Preferences 会 让 你 注销 并 重新 登录 来 查看 结果 。 还 有 一 种 方法 : EVE 
escape 键 ， 选 择 Finder， 单 击 Relaunch。Finder 就 会 用 你 选 的 语言 出 现 。 


S ‘TE 当 在 Lanpguage&cText 面 板 下 的 时 候 ， 查 看 Formats 选 项 卡 确 保 Repgion 要 与 你 所 选 的 语言 相 匹配 。 切 换 应 当 自 动 完成 ， 
但 是 如 果 你 创建 了 一 个 自 定 义 格式 ， 它 会 卡 住 。 如 果 发 生 了 这 种 情况 ， 你 在 应 用 中 不 会 看 到 本 地 化 后 的 日 期 和 时 间 格 式 。 


如 果 修 改 InfoPlist.strings 后 一 切 进 行 顺 利 ，Finder 应 当 将 Mac Passer Rating 显 示 成 Quart-Efficacite， 见 图 21.11。 





Quart-Efficacite 


Application - 6,9 Mo 
Creation 12 novembre 7014 3:77 PM 
Modification hier 3303 PM 
Dernière ouw. hier 3:03 PM 
vamión 1.0 
+ lags... 


图 21.11 当 在 法 语 Findet 中 展示 时 ，Mac Passer Rating 4 Sa A Quart-Efficacité 


21.6 小结 


在 本 章 中 ， 我 概述 了 本 地 化 一 个 Mac 应 用 的 过 程 ; 同样 的 技术 也 适用 于 iOs。 


你 看 到 了 如 何 为 应 用 模板 添加 到 默认 的 Base.Iproj 目 录 中 的 文件 做 本 地 化 处 理 ， 同 时 还 有 如 何 为 项 目 和 一 个 未 本 地 化 的 文件 
添加 本 地 化 功能 。 


然后 我 继续 进 解 了 翻译 菜单 (容易 ) 和 UI 布局 的 技 I5。 以 前 ， 如 果 想 要 本 地 化 布局 ， 你 必须 以 某 种 万 式 生 成 单独 的 XIB 文 
件 。lbtool 命 令 行 工 具 实 现 了 从 XIB 中 提取 字符 串 并 插入 另 一 文件 中 ， 但 这 个 过 程 也 很 容易 出 错 。 现 在 的 Xcodes 以 及 应 用 框架 可 
以 在 运行 时 处 理 .strings 文 件 ， 只 需要 几 次 单 击 操作 (还 有 给 翻译 员 语 音信 箱 的 几 次 留言 ) 。 


然后 我 介绍 了 在 应 用 代码 中 应 用 .string 文 件 的 技术 : 处 理 Finder 字 符 串 的 InfoPlist.strings， 还 有 之 前 需要 硬 编码 的 字符 串 
文件 : Localizable.strings, 


我 们 开始 关心 Mac Passer Rating 如 何在 Finder 中 展示 自己 ， 所 以 我 们 经 历 了 添加 图 标 和 文件 类 型 到 应 用 包 中 的 复杂 过 程 。 


我 还 介绍 了 如 何在 运行 时 以 及 Finder 中 测试 应 用 程序 本 地 化 的 功能 。 


第 22 草 程序 包 


很 多 Xcode 产品 都 采取 程 序 包 (packages) 的 形式 ， 它 是 一 个 目录 树 ， 但 是 在 Finder 中 显示 为 单个 文件 。 让 我 们 暂停 下 ， 
先 考 虑 下 资源 的 问题 。 资 源 是 集成 在 应 用 程序 中 的 各 种 数据 ， 但 是 由 于 各 种 原因 无 法 合并 到 源 代码 中 : SAR. BHR. BR. 
用 尸 界面 布局 、 声 音 等 ， 诸 如 此 类 的 数据 。 


在 原始 Mac OS 中 ， 应 用 程序 将 资源 放 在 resource forks (资源 分 支 ) 中 ， 它 是 用 于 保存 数据 流 的 小 型 数据 库 ， 我 们 通常 可 
以 将 它 视 为 文件 。Resource Manager 的 问题 在 于 它 对 大 量 、 大 型 或 者 可 更 改 的 俊 源 的 支持 不 好 。 写 入 每 个 资源 的 目录 非常 脆 
弱 ， 任 何 中 断 都 可 能 导致 文件 中 所 有 资源 的 丢失 。 现 代 App 使 用 了 大 量 大 型 资源 ， 管 理 这 些 资源 的 任务 与 文件 系统 的 任务 难以 区 
分 。 文 件 系统 是 一 个 很 好 的 解决 方案 ， 经 过 多 年 的 积累 ， 文 件 系统 已 经 变 得 越 来 越 有 效率 ， 也 越 来 越 健 壮 。 为 什么 不 使 用 文件 系 
仔 取 资 源 ? 


避免 将 应 用 程序 资源 作为 各 个 独立 文件 的 一 个 原因 就 是 依赖 文件 系统 的 应 用 程序 将 会 涉及 大 量 的 文件 和 目录 ， 这 些 文件 和 目 
录 对 于 应 用 程序 的 正常 运行 非常 重要 ， 所 有 的 文件 和 目录 都 可 能 被 用 户 重 定位 、 删 除 和 滥用 。 同 时 ， 想 仅 仅 借助 应 用 程序 完成 工 
作 的 用 户 也 会 看 到 大 量 的 文件 和 目录 。 


OS X 提 供 了 一 种 灵活 的 方法 将 资源 分 离 到 它们 自己 的 文件 中 ， 同 时 避 开 了 大 量 文件 的 问题 。Finder 将 这 些 目录 称 为 
packages， 尽 管 它 们 都 是 单 文档 。 


22.1 简单 的 包 : RTFD 


可 以 将 一 个 程序 包 视 为 包含 少量 文件 的 目录 。 创 建 和 读 取 包 的 应 用 程序 决定 了 它 的 结构 : 需要 什么 文件 ， 内 容 文件 的 名 称 ， 
以 及 使 用 什么 样 的 子 目录 结构 。 


应 用 程序 定义 的 包 的 常见 例子 是 RTFD， 或 者 是 富 文本 文件 目录 (rich text file directory) 。Apple 提 供 的 应 用 程序 
TextEdit， 在 它 的 Info.plist 文 件 中 ， 指 定 了 它 能 处 理 的 文档 类 型 。 其 中 包含 一 个 名 为 NSRTFDPboardType 的 类 型 ， 它 带 有 rtfd 
的 后 弘 ， 指 定 作为 包 文件 类 型 。 当 它 添加 到 TextEdit 后 ，Finder 惑 知道 带 有 .rtfd 扩 展 名 的 目录 是 包 文 件 ， 所 以 会 将 它们 视 为 单个 
文件 处 理 ， 而 不 是 像 平 常 那样 展示 包 中 的 文件 。 


有 的 时 候 碍 看 下 包 内 容 也 很 有 用 ，Finder 提 供 了 一 种 万 法 可 以 这 样 做 。 右 击 一 个 包 文件 束 会 弹出 一 个 菜单 ， 其 中 包含 一 个 命 


令 Show Package Contents ( 见 图 22.1) 。 选 中 这 个 命令 就 会 打开 一 个 新 的 窗口 ， 窗 口中 会 显示 包 目 录 ， 单 击 这 个 目录 就 能 像 
在 普通 的 Finder 窗 口中 浏览 。 


aa 

到 "中 

Bees DE rE ee ee ee 
wo 

ae ms. ae 

LEE LEETE sl EE ie Phe LLN EA Be a PE 
DE "sl San ee PE a: a a ee EA 

是 es 


He be AAEL ee 


icon60@2x.png 


Date Modifiad Si Kind 


Despondeni&žx png Today, 5:04 PM IK PNG image 
Elatec@ex.pong Today, 2:04 PMI iR PAG image 
O iconé0@2x.png 7) Today, 5:04 PM 
l Today, 2:04 PMI rich text (ATF) 





图 22.1 右 击 Findet 中 的 包 文 档 就 会 弹出 一 个 带 有 Show Package Contenhts 命 令 的 菜单 ， 执 行 这 条 命令 就 会 显示 包 中 的 所 有 文件 


对 于 RTFD 来 说 ， 包 目录 中 包含 一 个 纯 RTF 文 件 ，TXT.rtf。RTF 文 件 中 包含 自 定 义 标记 ， 比 如 说 : 


The icon looks like this:\ 


\ 
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480 
\tx5040\tx5600\tx6160\tx6720\pardirnatural 

\cf0 {{\NeXTGraphic icon60@2x.png \width2400 \height2400 

EFA 


这 里 ， 标 记 指 向 了 一 个 图 形 文 件 。 在 这 个 例子 中 ， 指 向 了 icon60@2x.png， 它 也 在 RTFD 目 录 中 。 


Ore Cocoa 的 AppKit 应 用 程序 框架 提供 了 包 目 录 文 档 的 支持 。NSDocument 子 类 通过 重 写 
readFromFileWrapper (-, ofType:, error:) 和 fileWrapperOfType (-, error:) 方法 处 理 包 的 读 取 和 写 入 。NSFileWrapper 类 提供 了 可 
助 创建 和 管理 复杂 和 包 的 方法 。 


22.2 bundle 








bundle 是 一 种 特定 类 型 的 结构 化 目录 树 。 通 常 ， 类 型 ， 举 个 例子 : 应 用 程序 
一 一 但 是 概念 是 分 开 的 。 一 个 目录 可 以 是 一 个 bundle 而 不 是 一 个 package; 一 个 目录 也 可 以 是 一 个 package 而 不 是 一 个 
bundle; 或 者 一 个 目录 既是 bundle 也 是 package。 表 22.1 给 出 了 例子 。 








AS 


表 22.1 目录 是 bundle 或 者 是 packapge 或 者 两 者 都 是 的 例子 


Not Bundle Bundle 





Not Package | Other directories Frameworks 





Package Complex documents | Applications 


OS X 中 有 两 种 类 型 的 bundle: versioned bundle， 它 用 于 框架 一 一 包含 动态 库 、 头 文件 还 有 支撑 它们 的 资源 文件 一 一 和 
modern bundle， 它 用 于 应 用 程序 和 大 多 数 其 他 可 执行 产品 。 


Wis Modern 是 一 个 相对 术语 ，modern packages 在 Cocoa 之 前 就 已 经 出 现在 NeXTStep 中 了 。 


最 起 码 ，modern Mac bundle 包 含 一 个 名 为 Contents 的 目录 ， 这 个 目录 包含 组 成 bundle 的 全 部 目录 和 文件 。Contents 目 
录 包 含 一 个 Info.plist 文 件 ， 它 指定 了 bundle 如 何在 Finder 中 显示 以 及 根据 bundle 的 类 型 ， 它 可 能 提供 载 入 和 运行 bundle 内 容 
的 配置 数据 。 除 此 之 外 ，Contents 文 件 夹 包含 的 内 容 还 依赖 于 bundle 的 类 型 。 


22.3 ”应 用 程序 的 bundle 


OS X 应 用 程序 是 最 常见 的 bundle 类 型 ( 见 图 22.2) 。 一 个 应 用 程序 目录 名 字 后 面市 有 一 个 后 织 .app。 这 个 .app 目 录 束 是 一 
个 文件 package; 即便 它 是 一 个 目录 ，Finder 还 是 会 将 它 视 为 一 个 单独 的 实体 。 它 允许 应 用 程序 作者 在 已 知 位 置 蔡 换 应 用 程序 的 
辅助 文件 一 一 在 应 用 程序 bundle 本 身 中 一 一 基本 不 用 担心 这 些 文件 会 被 误 放 或 者 删除 。 


OS X 应 用 程序 bundle 的 Contents 目 录 通 常 包 合 : 


` Info.plist， 这 是 一 个 XML 属 性 文件 ， 它 描述 了 应 用 程序 的 细节 ， 比 如 说 主要 类 、 能 处 理 的 文档 类 型 以 及 应 用 程序 版 本 。 下 


一 节 我 们 会 详细 介绍 这 个 文件 。 


- Resoutces， 它 是 一 个 包含 应 用 程序 图 标 文件 、 图 片 、 声 音 、 人 机 交互 布局 以 及 其 他 应 用 程序 中 参数 化 内 容 的 目录 。 常 见 的 
内 容 ， 比 如 按钮 图 片 ， 可 能 会 在 Resoutces 目 录 本 身 中 找到 ; 本 地 化 的 文件 都 保存 在 .lptoj 目 录 中 。 通 常 有 ， 一 个 Base.lptoj 目 录用 于 
存放 默认 的 布局 和 字符 串 ， 还 有 一 个 额外 的 .lproj 目 录 支 持 特定 区 域 的 自动 化 设置 。 当 应 用 程序 查找 一 个 资源 的 时 候 ，Cocoa 或 者 
Core Foundation bundle 管 理 器 将 会 首先 查看 对 应 当前 语言 和 区 域 的 .lproj 目 录 。 


中 
常 


- MacOS， 它 是 包含 应 用 程序 二 进 制 数据 以 及 其 他 可 执行 数据 的 目录 。 


Frameworks， 它 是 一 个 框架 目录 ， 本 身 是 一 个 versioned bundles， 其 中 包含 动态 库 、 库 所 需要 的 资源 以 及 用 户 使 用 这 个 库 所 
需要 的 头 文件 。 一 个 应 用 程序 通常 包含 一 个 框架 ， 因 为 它 链接 了 框架 中 的 库 。 
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图 22.2 ”常见 应 用 程序 包 的 结构 。 可 执行 文件 在 Contents/MacOS/Application 目录 中 。 默 认 的 应 用 程序 人 机 交互 界面 在 一 个 编译 过 
的 storyboard 中 指定 ，Contents/Resources/Base.lproj/IMain.storyboardc; 由 此 推测 ，French 版 本 的 .strings 文 件 在 
Contents/Resources/ft.lptroj 文 件 夹 中 。 按 钮 的 自 定义 图 片 Login_button.png 对 所 有 的 语言 都 适用 ， W E T Æ Resources H R F 








全 注意 iOS App 是 什么 呢 ? 它们 是 packages 一 一 Findet 将 它们 视 为 统一 文件 一 一 但 不 是 bundles。 除 了 本 地 化 的 .lproj 目 隶 和 
显示 添加 到 应 用 程序 资源 中 的 目录 外 ， 其 他 目录 都 在 .app bundle 目 录 中 。 让 我 们 看 下 : 按 住 option 键 ， 然 后 在 Findet 的 Go 菜单 中 选 
择 Library。 浏 览 Developer/Xcode/DerivedData 目 录 ， 查 找 你 的 OS 项 目 名 (这 个 名 字 后 面 有 长 长 一 串 哈 希 字符 ) 。 在 那个 目录 

中 ，Build/Products 内 可 以 找到 构建 配置 组 合 的 目录 以 及 目标 操作 系统 。 你 的 .app 文 件 也 会 在 这 里 。 右 击 任何 一 个 文件 ， 然 后 选择 


Show Package Contents. 


22.4 Info.plist File 


Info.plist 文 件 在 任意 modern bundle 的 Contents 文 件 夹 和 iOS 应 用 程序 .app 的 bundle 根 目录 中 ， 它 是 OS X 和 iOS 理 解 
bundle 信 息 的 核心 文件 。 这 个 文件 为 Finder/Home 界 面 提供 了 应 用 程序 的 图 标 和 名 称 信息 ; 为 Launch Services 提 供 了 标志 和 
环境 变量 ; 以 及 用 于 iOS app 中 的 各 种 尺寸 和 朝向 的 “默认 ”界面 图 片 ， 并 指定 了 应 用 程序 和 插件 的 基本 结构 。 它 是 一 个 属性 列 
表 (plist) 目录 文件 ， 我 将 会 在 第 23 章 中 介绍 这 种 格式 。 


Target editor 的 Summary 和 Info 选 项 卡 为 target 的 Info.plist 生 成 了 一 个 专门 的 编辑 器 。 它 们 首先 会 过 滤 了 一 些 设置 ， 减 少 
了 很 多 麻烦 。 


你 也 可 以 使 用 Property List 编 辑 器 ( 见 第 24 章 ) 直接 编辑 Info.plist 文 件 。 事 实 上 ， 你 编辑 的 文件 并 不 是 Info.plist， 而 是 它 
的 父 文件 ， 最 后 Info.plist 会 放 到 产品 的 package 中 。 


你 看 到 的 Info.plist 只 不 过 是 Xcode 用 来 生成 最 终 属性 列表 的 源 文 件 。 在 这 个 处 理 阶段 允许 你 使 用 构建 变量 的 引用 而 不 是 各 
个 键 对 应 的 字面 值 。 处 理 特定 target 的 Info.plist 有 些 特殊 : 它们 并 不 包含 于 target 的 任何 构建 阶段 ， 它 们 仅 会 将 未 处 理 的 源 文 件 
复制 到 应 用 程序 的 Resources 目 录 中 。 文 件 名 通过 INFOPLIST _ FILE 这 个 构建 变量 设置 ， 构 建 系统 将 会 从 中 取得 对 应 的 值 。 


StS 有 大 量 的 构建 设置 用 来 控制 Info.plist 的 生成 。 查 看 Target editor? Build Setting 选 项 卡 下 的 Packaging 区 域 。 在 源 文件 
中 包含 一 些 使 用 C 风 格 预 处 理 器 指令 的 选项 。 不 幸 的 是 ， 一 旦 你 使 用 了 这 些 设置 ， 你 不 得 不 将 这 个 文件 视 为 XML 文件 来 处 理 ， 


A Property List 编 辑 器 会 销毁 所 有 不 属于 属性 列表 XML 的 内 容 。 


注意 大 多 数 targets 都 需要 有 自己 的 Info.plists。 拥 有 多 个 target 的 项 目 有 多 个 Info.plist 文 件 需 要 管理 。 在 Xcode 6 之 前 ， 通 
过 在 父 文件 前 面 如 上 tatget 的 名 称 的 方法 来 避免 潜在 的 冲突 ， 比 如 : myftamewotk-Info.plist。Xcode 6 坚持 将 target 文 件 放 在 它们 自己 
的 文件 夹 中 ， 丢 掉 了 使 用 tatget 名 作为 前 缓 的 做 法 ， 但 是 在 老 项 目 中 你 可 能 还 会 遇 到 这 个 问题 。 


本 地 化 Info.plist 
Info.plist 中 部 分 属性 可 以 本 地 化 。 名 为 InfoPlist.strings 的 文件 应 该 在 各 个 本 地 化 的 .lproj 文 件 夹 中 。 可 本 地 化 的 键 之 后 会 被 


赋值 为 各 个 区 域 对 应 的 值 。 比 如 ，English.lproj 目 录 中 的 InfoPlist.strings 中 可 能 包含 这 样 的 键 值 对 : 


CFBundleName = "PasserRating"; 
CFBundleDisplayName = "Passer Rating"; 


Fr.Iproj 目 录 中 的 相同 文件 可 能 会 包含 : 
CFBundleName = "Q-Effic"; 
CFBundleDisplayName = "Quart-Efficacité"; 
对 于 那些 偏好 使 用 French 而 不 是 English 的 用 户 来 沈 ，Mac Passer Rating 图 标的 标签 将 会 显示 为 Quart-Efficacite 这 个 字符 
串 。Bundle 目 录 名 仍然 是 PasserRating.app， 即 使 普通 用 户 都 不 会 看 到 它 。 


Xcode 的 Property List editor 会 自 适 应 Info.plist。 当 文件 名 以 Info.plist 结 尾 的 时 候 ， 它 就 会 将 字典 键 值 列 填充 为 带 有 那 种 
属性 列表 的 弹出 菜单 。 这 就 意味 着 你 应 该 避免 使 用 Xcode 来 编辑 这 样 结尾 的 属性 列表 文件 (比如 用 来 存储 姓名 和 地 址 的 
Directorylnfo.plist 文 件 ) ， 但 并 不 是 真正 的 Info.plist。 


22.5 ”Info.plist 中 用 于 应 用 程序 的 键 


Info.plist 键 值 已 经 广泛 应 用 到 越 来 越 多 需要 目 定 义 需 求 和 应 用 程序 功能 的 OS 服务 中 。 在 本 书 早期 的 版 本 中 ， 我 可 以 列 出 几 
乎 所 有 可 用 的 键 一 一 即使 有 一 些 名 字 甚 至 没有 在 互联 网 中 出 现 过 。 但 是 现在 已 经 不 可 能 列 出 来 了 。 


这 里 你 看 到 的 将 会 是 应 用 程序 Info.plists 中 最 常用 的 键 。 我 将 字典 中 的 键 条 目 化 ， 后 面 跟 看 的 是 在 Property List 编 辑 器 中 使 
用 的 纯 天 语 标签。 
22.5.1 用 于 iOS 和 OS X 的 键 

本 节 介 绍 的 键 既 可 以 应 用 在 OS X 的 bundle 中 ， 也 可 以 用 于 iOS 的 bundle 中 。 
结构 


- CFBundleExecutable (可 执行 文件 ) ， 它 是 可 执行 文件 名 ， 可 执行 文件 可 能 是 二 进 制 的 应 用 程序 ， 也 可 能 是 库 文件 ， 还 有 
可 能 是 插件 代码 。 它 对 应 于 构建 设置 中 的 EXECUTABLE_NAME， 而 这 个 值 又 继承 于 PRODUCT_NAME (增加 了 可 选 的 前 组 和 


后 级 ， 不 过 很 少 使 用 ) 。 一 个 bundle 若 这 一 项 与 可 执行 文件 的 实际 名 称 不 相 匹 配 则 无 法 运行 。 应 用 程 友 必 须 指 定 这 个 键 值 。 


- CFBundleIdentifier (Bundle Identifier) ，bundle 的 唯一 标识 字符 串 ， 它 的 格式 类 似 于 Java 风 格 的 包 名 ， 比 如 com.wt9t.Passef- 
Rating。Xcode 使 用 你 选择 项 目 模板 时 提供 的 company ID 来 初始 化 这 个 值 ， 其 后 是 ${PRODUCT_NAME:rtf1034identifier} 。 所 有 的 


bundle 必 须 都 要 指定 这 个 键 值 。 


- CFBundleInfoDictionaryVersion (InfoDictionary 版 本 ) ， 它 是 用 于 Info.plist 进 行 格 式 兼 容 性 检查 的 版 本 号 。Xcode 构 建 bundle 
的 时 候 会 自动 揪 入 这 个 版 本 号 。 我 从 来 没有 看 到 过 不 是 6.0 的 版 本 号 。 所 有 的 Info.plist 文 件 都 应 该 包含 这 个 键 。 


- CFBundlePackageType (Bundle OS Type code) ， 这 个 值 在 OS 上 是 可 选项 ， 它 是 bundle 使 用 的 4 个 字符 的 类 型 代码 。 应 用 程 
序 的 类 型 是 APPL，, 框架 的 类 型 是 FMWK， 插 件 的 类 型 是 BNDL 或 者 你 选择 的 代码 。 参见 CFBundleSiegnature。 OS X 应 用 程序 必须 指 


定 这 个 键 。 


- CFBundleSignature (Bundle creator OS Type code) ， 这 个 值 在 OS 上 是 可 选项 ，4 个 字符 的 creator code 与 bundle 相 关联 。OS 


X 应 用 程序 必须 制定 这 个 键 ， 但 是 大 多 数 时 候 这 个 键 值 都 是 “????”。 


- NSPrincipalClass (#=#) ， 它 是 bundle 主 类 的 名 字 。 在 OS 义 应 用 程序 中 ， 通 常 是 NSApplication; AiOS?, i iz 
P pp 


UIApplication 。 


- NSMainNibFile ( 主 nib 文 件 基本 名 ) ， 应 用 程序 主 NIB 文 件 的 基本 (不 带 扩 展 名 ) 名 称 ， 在 OSX 上 几 和 平 总 是 MainMenu， 在 
iOS 上 是 MainWindow ( 当 只 使 用 一 个 主 NIB 的 时 候 ) 。 使 用 NSMainNibFile~ipad ( 主 nib 文 件 基本 名 (iPad) ) 为 在 iPad 上 启动 的 应 
用 程序 指定 一 个 单独 的 NIB。 


- NSMainStoryboardFile ( 主 storyboard 文 件 的 基本 名 ) ， 应 用 程序 的 主 Storyboard 文 件 的 基本 名 (不 带 扩 展 ) ,在 OS X Lid 


是 Main; 在 i1OS 上 与 之 对 应 的 是 UIMainStoryboardFile。 见 下 面 。 


用 户 信息 


- CFBundleGetInfoString (Get Info String) ， 这 个 选项 只 存在 于 Mac， 它 补充 了 由 CFBundleShortVetrsionString 和 


CEFBundleVetsion 提 供 的 版 本 人 信息。 之前， 这 个 键 值 用 于 版 权 信 息 字 符 串 ， 但 是 现在 版 权 信 息 字 符 串 由 NSHumanReadableCopytight 


处 理 。 


- CFBundlelconFile (Icon file) ， 它 是 Resoutces 目 录 下 包含 bundle 自 定义 图 标的 名 字 ， 在 Mac 上 是 .icns 格 式 的 文件 ， 在 iOS 
是 png 文件 。 你 可 以 忽略 这 个 扩展 名 。iOS 应 用 程序 更 喜欢 使 用 CFBundleIconFiles， 它 是 应 用 程序 图 标 不 同 泻 染 尺寸 对 应 的 标准 化 
名 的 数组 。 


` 这 些 在 Xcode 6 中 都 没有 什么 实际 意义 。Tatget 编 辑 器 下 面 的 Genetal 选 项 卡 能 让 你 指定 icons 的 图 标 ， 无 论 是 通过 一 个 个 的 文 
件 指 定 ， 还 是 通过 资源 目录 指定 。 在 这 个 操作 之 后 ， 构 建 系 统 会 将 所 需 的 图 标 引 用 插入 Info.plist 中 。 


- CFBundleShortVersionString (Bundle versions string,short) ，bundle 中 这 有 产品 版 本 的 短 字 符 串 ， 比 如 4.3.4， 它 适合 在 About 
对 话 框 中 显示 或 者 在 应 用 商店 中 显示 。 同 样 可 见 CFBundleGetInfoString。 这 个 键 值 可 以 使 用 InfoPlist.strings 本 地 化 。 应 用 程序 必须 
指定 这 个 值 。 


- CFBundleVersion (Bundle version) ，bundle 可 执行 文件 的 构建 版 本 。 过 去 ， 这 个 字符 串 基 本 上 等 于 短 版 本 字符 囊 ， 可 能 带 
有 一 个 后 级， 比如 b2 表 示 前 一 个 版 本 ， 或 者 生成 这 个 二 进 制 文件 的 构建 序列 号 : 2.1b4 (2133) 。 现 在 的 做 法 是 仅 使 用 构建 序列 
号 。iOS 拒 绝 在 应 用 程序 已 经 存在 的 情况 下 ， 再 安装 一 个 相同 的 应 用 程序 ， 除 非 这 个 应 用 程序 的 版 本 比 已 安装 的 应 用 程序 的 版 本 
。 整数 形式 的 序列 号 很 容易 生成 ，iOS 也 很 容易 解析 这 个 序列 号 。 


at 


- CFBundleDisplayName (Bundle display name) ， 在 Findet 中 或 者 Home 界 面 中 显示 的 bundle 名 称 。Info.plist 中 的 这 个 值 应 该 与 
应 用 程序 bundle 名 一 致 。 本 地 化 的 名 字 可 以 放 入 InfoPlist.strings 文 件 中 用 于 多 种 语言 。OS 仅 会 在 文件 系统 的 应 用 程序 包 名 与 这 个 
键 值 相等 的 时 候 才 会 显示 本 地 化 的 名 字 。 因 为 ， 如 果 一 个 Mac 用 户 将 你 的 应 用 程序 重 命名 ， 那 么 他 想 要 的 名 字 一 一 而 不 是 本 地 化 
的 名 字 一 一 将 会 显示 出 来 。 项 目 模板 将 会 使 用 {PROJECT_NAME} 初 始 化 这 个 键 值 。 参 见 CFEBundleName。 应 用 程序 必须 指定 这 个 


键 。 





- CFBundleName (Bundle name) ， 它 是 应 用 程序 名 称 的 简写 最 大 为 16 个 字符 ， 这 个 名 字 将 会 现在 About 对 话 框 和 
Application 菜单 中 。 同 样 见 CFBundleDisplay Name。 这 个 键 可 能 会 使 用 InfoPlist.strings 本 地 化 。Xcode 使 用 ${PRODUCT_NAME} 初 
始 化 这 个 键 值 。 应 用 程序 必须 指定 这 个 键 值 。 


本 地 化 


CFBundleDevelopmentRegion (初始 开发 区 域 的 本 地 化 ) ， 原 生 语言 ， 或 者 bundle 中 各 种 各 样 的 本 地 语言 ， 比 如 用 于 
Canadian French 的 fr-CA。 如 果 用 户 在 某 个 地 方 无 法 使 用 当地 的 语言 ， 那 么 可 以 使 用 这 个 语言 。 


文档 和 URL 


- CFBundleDocumentTypes (文档 类 型 ) ， 它 是 一 个 字典 数组 ， 指 定 了 与 应 用 程序 相关 联 的 每 个 文档 类 型 。 使 用 Target 编 辑 


器 下 的 Info 选 项 卡 编辑 这 些 类 型 ， 它 将 会 减轻 你 的 痛苦 。 


- CFBundleURLTypes (URL 类 型 ) ， 定 义 URL scheme 的 字典 数组 ， 比 如 http:、ftp:， 或 者 x-com-wt9t-custom-scheme: ， 对 于 
它们 来 说 应 用 程序 是 一 个 处 理 器 。 小 心 使 用 常见 的 schemes， 如 果 你 的 应 用 程序 是 一 个 网 页 浏览 器 ， 那 么 你 必须 支持 http: ,但 是 
如 果 你 仅仅 想 从 HTTP 服 务 器 中 抓 取 一 些 资源 ， 那 么 不 要 让 整个 系统 都 能 为 http URL 提 供 服务 。 在 iOS 中 这 个 标签 很 有 用 ， 你 的 应 
用 程序 可 以 为 其 他 应 用 程序 提供 在 应 用 程序 、 邮 件 和 网 页 之 间 方 便 通 信 的 方法 。 详 情 见 Apple 文 档 中 Target 编 辑 器 下 的 Info 选 项 
卡 。 


- UTExportedTypeDeclarations (Exported Type UTIs) ， 它 是 一 个 字典 数组 ， 用 来 描述 应 用 程序 能 够 写 入 的 文档 类 型 ， 以 及 


你 想 让 Launch Service 了解 的 信息 。 这 些 条 目 关注 于 声明 一 个 UTI 和 UIT 链 以 及 主 UTI 遵 循 的 协议 。 Spotlight 用 这 个 键 构 建 它 的 文档 


类 型 。 从 OS X10.5 开 始 ，UTI 的 优先 级 高 于 CFBundleDocumentIType 的 优先 级 。 同 样 ， 在 Tateet 编 辑 器 的 Info 选 项 卡 下 很 容易 管理 
这 个 列表 。 在 Apple 的 文档 中 可 以 看 到 这 个 字典 的 详细 格式 信息 。 


- UIImportedTypeDeclarations (Imported Type UTIs) ， 一 个 字典 数组 ， 它 描述 了 应 用 程序 能 读 取 的 文档 类 型 ， 并 可 能 想 要 
Launch Service 了解 这 一 点 。 这 些 条 目的 格式 与 UTExportedTypeDeclarations 中 的 条 目 格 式 相 同 。Target editot 中 Info 选 项 卡 为 此 提供 


个 简单 的 编辑 器 。 


22.5.2 OS X 中 使 用 的 键 


这 些 键 值 只 能 用 于 OS X 应 用 程序 ， 其 中 涵盖 了 局 动 配置 、 帮 助 工 具 还 有 文档 信息 以 及 应 用 程序 处 理 的 URL。1nfo.plist 结 构 
早 于 OS X 的 出 现 ， 所 以 很 多 键 都 已 经 过 时 ， 但 是 OS 不 得 不 做 向 后 兼容 。 新 应 用 程序 target 对 应 的 模板 初始 化 的 时 候 会 为 你 提供 
启动 所 需 的 所 有 人 参数， 同时 Info 选 项 卡 将 会 帮助 你 ， 它 提供 了 几乎 所 有 你 需要 用 来 填充 的 值 ， 但 是 没有 用 来 跟 趴 OS 发 布 笔 记 的 
蔡 代 品 。 


结构 


- CSResoutcesFileMapped (资源 应 该 是 映射 文件 ) ， 如 果 选 择 YES 或 者 二 true/ > Core Foundation 就 会 将 bundle 资 源 做 成 内 存 
映射 而 不 是 将 文件 读 入 内 存 中 。 


- ATSApplicationFontsPaht (应 用 程序 字体 资源 路 径 ) ， 它 是 一 个 字符 事 。 如 果 你 的 应 用 程序 包含 自己 使 用 的 字体 ， 它 就 会 
包含 指向 字体 的 路 径 ， 这 个 路 径 相对 于 应 用 程序 Resourtce 目 录 。 


用 户 信息 
- NSHumanReadableCopyright (Copyright (用 户 可 读 ) ) ， 一 个 适合 在 About 对 话 框 中 显示 的 版 权 字 符 串 。 这 个 键 可 能 会 在 


InfoPlist.strings 中 本 地 化 。 应 用 程序 必须 指定 这 个 键 。 


- LSApplicationCategotyType (应 用 程序 分 类 ) ， 它 是 一 个 包含 Apple 定 义 的 UTI 的 字符 串 ， 用 来 向 Mac 应 用 商店 描述 应 用 程序 
的 种 类 Business (商业 ) , Lifestyle (生活 ) , Video (视频 ) 等 。 一 般 情 况 下 ， 你 需要 在 应 用 程序 Tatget 编 辑 器 的 Summaty 选 





项 卡 下 设置 这 个 值 。 当 你 通过 iTunes Connect 提 交 这 个 App 的 时 候 ， 你 可 以 选择 两 个 分 类 ， 确 保 主 分 类 与 LSApplicationCategoryType 
的 值 保 持 一 致 。 


帮助 


- CFAppleHelpAnchor (帮助 文件 ) ， 带 扩 展 名 的 基本 名 ， 应 用 程序 初始 化 的 帮助 文件 。 


- CFBundleHelpBoolFolder (帮助 手册 的 目录 名 ) ， 这 个 文件 夹 一 一 要 么 在 Resoutces 的 子 目 录 中 ， 要 么 在 本 地 化 的 子 目录 中 
包含 应 用 程序 的 帮助 手册 。 


- CFBundleHelpBookName (帮助 手册 标示 符 ) ， 它 是 应 用 程序 帮助 手册 名 。 这 个 名 字 应 该 与 帮助 手册 中 根 文件 里 面 标 签 中 
的 名 字 一 致 。 


这 些 键 控制 着 Launch Services 如 何 局 动 并 控制 一 个 Mac 应 用 程序 。iOS 有 一 个 Launch Services 框 架 ， 但 是 没有 提供 公共 接 


- LSBackgroundOnly (仅仅 是 后 台 应 用 程序 ) ， 如 果 它 的 值 是 字符 串 “1 ”， 那 么 应 用 程序 将 仅 会 在 后 侣 运行 ， 用 户 不 可 


-LSEnvironment (环境 变量 ) ， 它 是 一 个 目录 ， 其 中 的 键 值 都 是 环境 变量 的 名 称 ， 定 义 在 应 用 程序 启动 的 时 候 传 入 的 环境 


- LSGetAppDiedEvents (4 Jf] #27 得 到 App 终 止 事件 ) ， 如 果 对 应 的 值 为 YES 或 者 <ttue/>， 那 么 当 任何 子 进 程 结束 
的 时 候 应 用 程序 都 将 会 得 到 名 为 KAEApplicaiton Died 的 事件 。 


- NSSupportsSuddenTermination (应 用 程序 可 以 在 刚 启 动 的 时 候 立 即 被 终止 ) 。 当 你 登录 、 重 启 或 者 关闭 计算 机 的 时 候 ，OS 
X 会 让 所 有 正在 运行 的 应 用 程序 都 能 有 机 会 做 清理 工作 ,询问 用 户 保 存 文档 等 。 如 果 这 个 键 是 <true/ >， 那 么 系统 将 会 使 用 一 个 
BSD 终 止 信号 来 关闭 应 用 程序 。 你 仍然 可 以 使 用 NSProcessInfo 方 法 恢复 ask-first 策 略 (比如 当 你 写 入 一 个 文件 的 过 程 中 ) ， 
kill 策 略 会 更 快 地 执行 关闭 操作 。 


- LSMinimumSystemVersion (最 低 的 系统 版 本 ) ， 这 是 一 个 形 如 10.xx 的 字符 串 ， 它 指定 了 应 用 程序 运行 需要 的 最 低 操 作 系 
统 版 本 。 在 OS X 中 ， 如 果 当 前 的 OS 版 本 较 早 〈10.4 之 前 的 版 本 ) ， 它 将 会 弹出 一 个 警告 ， 表 示 这 个 App 无 法 运行 
- LSMinimumSystemVersionByArchitecture (每 个 CPU 架构 下 最 低 的 系统 版 本 ) ， 它 是 一 个 字典 ， 可 能 的 键 值 为 1386 或 者 


x86_64。 每 一 个 键 对 应 的 值 都 是 包含 3 个 版 本 号 (比如 10.6.3) 的 字符 串 ， 这 个 字符 串 代 表 了 应 用 程序 支持 这 个 架构 最 低 的 OS X 


版 本 号 。 


- LSMultipleInstancesProhibited (应 用 程序 禁止 有 多 个 实例 ) ， 如 果 是 <true/>， 它 表示 应 用 程序 在 同一 时 间 只 能 有 一 个 可 


运行 的 应 用 程序 存在 。 比 如 ， 不 同 的 用 户 无 法 同时 使 用 这 个 应 用 程序 。 


- LSUIElement (应 用 程序 的 代理 [UIElementj) ， 如 果 将 它 设置 为 字符 串 1， 这 个 应 用 程序 将 会 被 视 为 一 个 agent 
application (代理 应 用 程序 ) ， 它 是 不 会 显示 在 Dock 中 的 后 台 应 用 程序 ， 但 是 如 果 有 必要 ， 它 可 以 显示 用 户 界 面 元 素 。 


了 


Dock 和 菜单 栏 





- LSUIPresentationMode (应 用 程序 UI 显示 模式 ) ， 它 是 一 个 0 到 4 之 间 的 整数 ， 表 示 日 益 增 多 的 OS XU 


序 运行 的 时 候 隐藏 。 详 情 参见 Apple 文 档 。 





其 他 服务 


- LSFileQuarantineEnabled (启用 文件 隔离 ) ， 如 果 它 的 值 为 二 true/ > Launch Setvices 会 把 应 用 程序 创建 的 文件 视 为 从 网 上 
下 载 的 文件 ， 警 告 用 户 打 开 这 个 文件 可 能 会 有 有 风险。 使 用 LSFileQuarantineExcludePahtPatterns 可 以 将 文件 从 隔离 区 中 排除 。 


- LSFileQuarantineExcluedPathPatterns (没有 相关 的 editor) 是 一 个 用 于 文件 (地 点 、 扩 展 名 等 ) 的 glob 通 配 符 模式 的 数组 ， 


它 会 将 符合 条 件 的 文件 从 隔离 区 中 排除 ， 即 便 这 个 文件 已 经 将 LSFileQuatantineEnabled 设 置 为 ttue。 
- NSAppleScriptEnabled (脚本 化 ) ， 如 果 为 YES 或 者 二 true/ >， 表 示 这 个 应 用 程序 可 脚本 化 。 应 用 程序 必须 指定 这 个 值 。 


- OSASctiptingDefinition (脚本 文件 名 ) ， 它 是 .sdef 文 件 名 ， 这 个 文件 可 以 在 应 用 程序 的 Resources 目 录 下 找到 ， 这 个 目录 也 
包含 AppleScript 脚 本 H Ko 


- NSSetvices (服务 ) ， 它 是 一 组 声明 了 这 个 应 用 程序 所 能 处 理 的 OS X 服 务 的 字典 ， 它 将 显示 在 每 个 应 用 程序 的 应 用 程序 
单 下 的 Services 子 菜单 中 ， 它 属于 系统 偏好 中 Keyboatrd 面 板 下 Keyboard Shortcuts 选 项 卡 。 这 个 字典 指定 了 粘贴 板 的 输入 和 输出 文件 


格式 、 服 务 的 名 字 以 及 实现 这 个 服务 的 方法 名 。 详 情 参 见 Apple 文 档 。 


22.5.3 1iOS 中 使 用 的 键 


了 这些 标 釜 专 门 用 于 iOS3 应 用 程序 。 一 般 情 况 下 ， 如 果 你 想 要 针对 特定 设备 自 定 义 任 何 Info.plist 中 的 键 ， 那 融 创 建 一 个 由 基本 
名 后 面 跟 着 一 个 分 号 ， 然 后 再 接 上 iphones 和 一 个 流 滔 号 ， 以 及 设备 标示 符 组 成 目 定 义 的 键 ， 比 如 UlstatusBarstyle-iphone- 
~ipad。 在 实际 使 用 中 ， 你 可 以 忽略 -iphones 这 一 部 分 : UlStatusBarStyle~ipad, 


结构 


- UIMainStoryboardFile, ，stotyboard 包 的 基本 名 ， 这 个 包 是 应 用 程序 的 根 。 可 以 使 用 这 个 键 值 或 者 NSMainNibFile， 但 是 不 能 
两 者 一 起 使 用 。 如 果 你 仅 有 一 个 用 于 iPhone 或 者 iPad 的 storyboard， 那 么 可 以 在 UIMainStoryboardFile 中 添加 ~ipad 或 者 ~iphone (ipad 
和 iphone 都 是 小 写 ) 。 


UILaunchStoryboardName (启动 界面 接口 文件 的 基本 名 ) ， 它 是 当 应 用 程序 启动 ，iOS 蔡 换 默 认 界 面 图 片 时 候 展 示 的 
storyboatrd 的 基本 名 。 随 着 界面 尺寸 的 增长 、storyboard 的 使 用 ， 它 可 以 适应 众多 尺寸 ， 这 种 做 法 比 为 每 种 大 小 的 界面 都 准备 一 张 
位 图 要 好 。 在 13.4.5 节 可 看 到 相关 的 讨论 。 


心 注意 如 果 没 有 启动 XIB 或 者 storyboard，iOS 就 会 认为 你 的 App 没 有 为 在 iPhone 6 或 者 6 Plus 上 的 运行 做 准备 。 如 果 只 有 图 
片 ， 你 的 App 将 会 根据 界面 的 大 小 缩放 图 片 。 


“LSRequiresIPhoneOS (应 用 程序 需要 iOS 环 境 ) ， 它 表示 在 非 :OS 设备 上 ，Launch Services 是 否 会 拒绝 启动 应 用 程序 。 这 是 
一 个 可 选 的 标签 ， 因 为 默认 情况 下 是 可 以 。 


- CFBundlelconFiles (图 标 文 件 ) ， 它 是 应 用 程序 图 标的 文件 名 数组 。 不 同 1OS 平 台 上 所 需 的 图 标 相 同 , 但 是 这 些 图 标的 尺 
寸 不 同 ， 系 统 将 会 在 这 些 文 件 中 寻找 一 个 合适 的 。 如 果 忽略 文件 扩展 名 ， 那 么 系统 将 会 自动 寻找 “@2x” 和 “3x” 的 Retina 
Display 变 量 。 重 写 CFEFBundleIconFile (可 选 ) 。 


- UlAppFonts (应 用 程序 提供 的 字体 ) ， 它 是 应 用 程序 bundle 中 提供 的 字体 文件 的 路 径 数 组 。 


- UIRequiredDeviceCapabilities (所 需 的 设备 的 功能 ) ， 字 符 串 数组 ， 比 如 telephony、wifi 或 者 video-cameta， 它 描述 了 若 想 要 
应 用 程序 正常 运行 ， 需 要 设备 提供 什么 功能 。 它 用 于 1Tunes 和 应 用 商店 中 ， 提 醒 那 些 没有 这 些 功 能 的 用 户 节省 开销 ， 不 要 购买 和 


A+ 


安装 这 个 App。 


- UlRequiresPersistentWiFi (应 用 程序 使 用 WiFi) o Property List 编 辑 器 的 描述 有 些 让 人 迷惑 。 默 认 情 况 下 ， 若 半 个 小 时 内 都 
没有 使 用 WiFi， 那 么 OS 将 会 关闭 这 个 连接 。 如 果 设 置 为 YES， 那 么 只 要 应 用 程序 启动 ，WiFi 传 输 就 会 随 着 应 用 程序 的 运行 开 
启 ， 并 一 直 持 续 到 应 用 程序 终止 。 


- UlSupportedExternalAccessoryProtocols (支持 额外 的 访问 协议 ) ， 它 是 一 个 字符 串 数 组 ， 列 举 了 应 序 支 持 的 所 有 外 部 
设备 协议 。 协 议 的 名 称 由 配件 制造 商 指定 。 


用 户 界 面 表现 


- UlStatusBarStyle (状态 栏 风格 ) ， 表 示 状 态 栏 的 初始 风格 〈 灰 色 透 明 或 者 黑色 不 透明 ) 。 在 iOS API 中 使 用 的 风格 名 字 ， 
默认 值 为 UIStatusBarStyleDefault。 


UIStatusBarHidden (状态 栏 初始 值 为 隐藏 ) ， 如 果 选 择 是 ， 当 应 用 程序 启动 的 时 候 状 态 栏 就 会 被 隐藏 。 在 节省 这 20 像 率 之 
前 ， 请 考虑 清楚 你 是 否 想 让 用 户 在 打算 查看 时 间或 者 电量 的 时 候 就 必须 关 挤 App。 


- UlInterfaceOrientation (初始 界面 的 朝向 ) ， 它 表示 应 用 程序 居 动 时 的 界面 朝向 。 在 UIKit 头 文件 中 查找 enum 
UJIInterfaceOrientation 的 可 用 值 。Info.plist 条 目 指 定 了 朝向 的 名 称 。 上 默认 值 是 UIInterfaceOrientationPortrait。 


- UlSupportedInterfaceOrientations (支持 的 界面 朝向 ; 支持 的 界面 朝向 [Pad]; 支持 的 界面 朝向 [iPhone]) ， 它 是 一 个 朝向 名 称 
组 ， 表 示 应 用 程序 在 iOS 或 者 iPad 上 支持 的 朝向 。 如 果 你 不 指定 UIInterfaceOrientation， 若 列表 中 有 设备 的 朝向 ， 那 么 OS 将 会 使 用 
设备 的 朝向 ; 若 没 有 ， 那 么 将 会 随机 选取 一 个 作为 默认 朝向 。~ipad 和 ~iphone 变 量 都 可 以 用 。 


.UIPrerenderdIcon (Icon 已 经 包含 了 光泽 和 倾 儿 效果 ) ， 如 果 值 为 YES， 那 么 iOS 就 不 会 再 为 它 添加 一 个 发 光 的 效果 。 这 个 
设置 在 iDOS 7 中 已 经 被 移 除 ， 以 后 都 不 会 为 图 标 添 加 发 光 效 果 。 


- UIViewEdgeAntialiasing (使 用 抗 锯齿 边缘 的 泻 娄 器 ) : 如 果 你 绘制 一 个 对 齐 到 亚 像 素 (fractional-pixel) 坐标 的 Cote 
Animation 层 ， 它 通常 不 是 反 锯 此 的 。 如 果 你 自 定 义 绘 制 方法 并 且 还 想 要 提高 性 能 ， 让 它 看 起 来 更 好 一 点 ， 那 么 可 以 将 这 个 值 设 
置 为 YES 。 


- UlViewGroupOpacity (使 用 透明 设置 组 泻 染 ) ， 如 果 这 个 值 为 YES， 那 么 就 允许 Cote Animation 的 子 层 继承 父 层 的 透明 度 。 
显示 效果 更 酷 ， 但 是 性 能 也 更 差 。 


- UlLaunchImageFile (启动 图 片 ) , UlLaunchImageFile~ipad (启动 图 片 [Pad]) 4#eULLaunchImageFile~iphone (启动 图 片 
[Phone]) ， 当 用 户 在 主 界 面 选 中 你 的 App 后 ， 这 张 图 片 就 会 显示 直到 App 的 内 容 演 染 完毕 ， 它 才 会 消失 。 之 前 有 尺寸 、 分 辩 率 和 
朝向 组 合 支 持 的 时 候 ， 它 的 工作 过 程 很 正常 。 现 在 使 用 UILaunchStotyboatdName 替 换 了 它 的 工作 ， 一 个 简单 的 storyboard 就 能 更 好 
地 完成 工作 。 不 过 ， 这 个 键 已 经 被 废弃 了 ， 由 http://www.hzcoutse.com/resoutce/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.. 取 代 。 


- UlLaunchImage (通过 Target editor/assets catalog 设 置 ) ， 它 是 一 个 字典 组 ， 描 述 了 当 App 启 动 的 时 候 ，iOS 可 能 显示 的 启动 
图 片 。 每 个 字典 都 指定 了 一 个 文件 名 、 最 小 的 OS 版 本 (所 以 你 的 启动 图 片 能 与 你 的 应 用 程序 在 OS 7 上 的 外 观 相 匹配 ) 、 大 小 和 
朝向 。 


- UlAppicationExistOnSuspend 〈 应 用 程序 不 会 在 后 台 运 行 ) ， 如 果 这 个 值 为 tue， 那 么 轻 击 iOS 的 Home 按 钮 就 会 关闭 的 你 的 


App， 而 不 是 让 它 转 入 后 台 运 行 。 在 你 发 布 App 之 前 要 仔细 考虑 这 个 问题 。 


- UlBackgourndModes 〈 需 要 后 台 模 式 ) 。iOS 通 第 不 会 为 处 于 后 台 的 应 用 程序 分 配 执行 时 间 ， 如 果 它 们 请 求 执 行 ， 那 么 执行 
时 间 也 不 能 超过 10 分 钟 。 特 殊 情 况 下 会 有 例外 ， 比 如 说 媒体 播放 、VoIP、 本 地 更 新 、 服 务 器 检查 等 。 上 声明 这 个 权限 最 简单 的 方 
法 就 是 在 Target 编 辑 器 的 Capabilities 选 项 卡 中 打开 Background Modes。 请 在 应 用 商店 的 审查 阶段 做 好 捍卫 你 的 行为 的 准备 。 


UIFileSharingEnabled 〈 应 用 程序 支持 iTunes 文 件 共 享 ) ， 如 果 这 个 选项 为 YES， 那 么 当 设备 连接 到 i 订 unes 的 时 候 ，App 中 的 
Documents/ 目 录 内 容 将 会 显示 在 iTunes 中 。 这 个 功能 允许 用 户 在 设备 和 计算 机 之 间 移 动 文件 。 


- UINewsstandApp (应 用 程序 在 Newsstand 中 展示 内 容 ) ， 如 果 设 置 为 <ttrue/>， 那 么 App 就 会 声明 它 是 一 个 用 于 Newsstand 
订阅 内 容 的 下 载 器 和 洽 染 器 。iOS 将 会 在 Newsstand 组 中 将 它 作 为 一 个 标题 显示 ， 而 不 是 一 个 独立 的 应 用 程序 。 如 果 你 提供 了 一 个 
Newsstand App， 那 么 你 必须 填充 另外 一 些 键 值 ， 比 如 UINewsstandIcon 。 


- NS*UsapgeDesctiption (Privacy-*Usage Desctiption， 隐 私 使 用 描述 ) ， x? 代表 11 个 与 隐私 相关 的 键 ， 比 如 Cameta、 
HealthShare、Location 或 者 PhotoLibrary。 这 个 列表 将 会 随 着 Apple 增 加 更 多 与 隐私 相关 的 功能 而 增加 。 对 于 你 的 应 用 程序 可 能 使 用 
的 每 个 功能 ，iOS 都 会 询问 用 户 是 否 给 予 对 应 的 访问 权 。 这 些 键 用 于 解释 你 为 什么 需要 使 用 这 些 功能 。 


- MKDirectionsApplicationSupportedModes 〈 地 图 寻 路 App 支 持 的 模式 ) 。 对 于 提供 方向 指引 的 应 用 程序 ， 它 是 一 个 交通 方式 
组 ， 比 如 这 个 App 提 供 了 一 个 包含 步行 、 公 交 和 地 铁 的 字典 。 使 用 Target 编 辑 器 中 Capabilities 选 项 卡 下 Maps 部 分 核对 你 提供 的 服 


务 。 


本 地 化 


Info.plist 中 有 大 量 的 键 表示 App 有 遵循 用 户 所 在 地 区 的 文本 和 显示 方式 的 能 力 。 第 21 章 中 介绍 了 这 些 键 。 


22.6 小结 


本 章 探 讨 了 bundles 和 package 目 录 ， 这 个 概念 对 于 iOS 和 OS X 开 发 来 说 都 相当 重要 。 大 多 数 Xcode 的 产品 类 型 都 是 
bundles。 我 查看 了 简单 package 和 应 用 程序 bundle 的 结构 ， 并 检查 了 lnfo.plist 文 件 ， 它 是 向 操作 系统 传递 bundle 元 数据 的 文 
件 。 


第 23 草 属性 刘表 


Cocoa 在 很 多 地 万 都 使 用 了 属性 列表 (property lists， 通 党 也 称 为 plist， 它 是 属性 列表 文件 常见 的 后 综 ) 。 它 们 是 通用 的 
结构 化 存储 媒介 ， 应 用 程序 资源 可 以 使 用 ， 甚 至 应 用 程序 文档 也 可 以 使 用 它们 。 昌 然 我 将 本 章 放 在 Os X 这 一 部 分 讲解 ， 但 是 属 
性 列表 对 iOS 开 友 者 来 说 也 相当 重要 。 


- Apple 中 很 多 配置 文件 的 标准 格式 都 是 属性 列表 键 值 、 树 的 简单 规范 。 如 果 你 想 要 自 定义 配置 文件 ， 可 能 不 如 专门 的 Plist 
SAF ATS 


. 尤其 是 ，iOS 和 OS X 上 面 的 应 用 程序 都 包含 一 个 Info.plist 文 件 ， 它 会 告诉 系统 这 个 App 将 如 何 显示 以 及 它 能 处 理 什么 数 


据 。 详 见 第 22 章 。 


- Propetty-list 的 文件 格式 相当 成 熟 ， 它 出 现 的 时 间 比 OS X 还 早 。Cocoa 能 逐 行 分 析 plist 文 件 ， 直 接 将 它 转 化 为 Foundation ( 基 


本 ) 数据 类 型 。 


SA 声明: Property list 是 Cocoa 开 发 的 核心 。 如 果 你 想 要 编写 在 iOS 和 QOS 义 上 运行 的 软件 ， 那 么 你 不 得 不 需要 能 用 肉眼 
读 取 它们 ， 手 动 创建 它们 ， 同 时 还 要 以 编程 的 方式 使 用 它们 。 它 们 没有 消失 。 查 看 本 章 结 尾 “ 其 他 格式 ”这 一 节 关 于 JSON 的 部 
分 。 越 来 越 多 的 产品 需要 与 服务 器 和 运行 于 其 他 操作 系统 的 设备 交换 数据 。 对 于 广泛 的 数据 交换 ，JSON 格 式 更 好 一 些 。 


23.1 属性 列表 数据 类 型 


属性 列表 是 由 Objective-C Foundation framework 提 供 的 基本 数据 类 型 的 文档 。 它 由 一 项 一 项 的 数据 组 成 ， 用 7 个 数据 类 
型 之 一 表示 。 其 中 有 5 个 属性 列表 类 型 是 标量 : number (包括 整数 和 实数 ) 、Boolean、string、date 和 data; 剩 下 两 个 是 复 
GRE: 有 序列 表 和 字典 。 一 个 有 序列 表 可 以 包含 零 个 或 者 多 个 属性 列表 类 型 的 对 象 。 一 个 字典 包含 零 个 或 者 多 个 键 值 对 ， 每 个 


键 值 对 由 一 个 键 字 符 串 和 一 个 属性 列表 类 型 的 值 对 象 。 


一 个 属性 列表 可 以 非常 简单 地 表达 大 多 数 数据 集合 。 单 个 game 中 一 个 passer 的 表现 可 以 由 字典 表示 ， 键 是 attempts、 
completions、interceptions、touchdowns 和 yards， 值 就 是 这 些 键 对 应 的 数字 。 一 场 game 也 可 以 由 一 个 字典 表示 ， 字 典 中 
包含 qdate、team name， 以 及 评估 表现 的 字典 。 


Core Foundation 和 Cocoa 都 提供 了 引用 计数 类 型 ， 这 些 类 型 对 应 属性 列表 的 类 型 ， 见 表 23.1。 


表 23.1 Cocoa 和 Core Foundation 中 的 属性 列表 类 型 
Data Type CocoaCore Foundation Markup 


, <integer> 
Number NSNumber CFNumber 
<float> 
= F <true/> 
Boolean NSNumber CFBoolean 
<false/> 


NSString CFString 


Text <string> 


NSMutableString CFMutableString 


Date NSDate CFDate <date> 


. NSData CF Data 
Binary Data p 7 
` NSMutableData CFMutableData 









<data> 
NSArray CFArray 
List _ E <array> 
NSMutableArray CF MutableArray 
LDC 
a NSDictionary CF Dictionary <key>... 
Associative Array E o. 7 _— | 
NSMutableDictionary CF MutableDictionary plist type ... 
<f/aict> 


事实 上 ， 你 可 以 将 一 个 Cocoa 属 性 列表 的 指针 传递 给 Core Foundation 来 表示 对 应 的 类 型 。 同 样 ， 你 也 可 以 使 用 
CFTypeRef 表 示 一 个 属性 列表 类 型 ， 而 然 它 是 一 个 指定 对 应 Cocoa 对 象 的 指针 ( 跨 过 Foundation Objective-C 与 Core 
Foundation pure-C 的 边界 将 会 引起 一 些 内 存 管理 的 问题 ，Automatic Reference Counting 本 身 无 法 解决 这 个 问题 。 在 
Documentation 组 织 器 中 搜索 Transitioning to ARC Release Notes 找 到 类 型 转换 家 族 bridge 的 细节 ， 它 能 为 ARC 提 供 所 需 的 
帮助 ) 。 


除 此 之 外 ，Swift 的 Array、Dictionary 以 及 标量 类 型 与 Foundation 数 据 类 型 紧密 地 结合 在 一 起 。 首 先 ， 在 这 个 语言 的 早期 
阶段 ， 它 们 之 间 的 结合 有 些 问 题 ， 其 次 ， 在 Swift 和 属性 列表 API 的 边界 ， 所 有 的 Dictionary 都 是 [String: AnyObject]， 所 有 的 
Arrays 都 是 [AnyObject]，AnyObject 是 Swift 类 型 ， 它 包含 了 Objective-C 对 象 ， 比 如 属性 列表 的 内 容 。 在 你 想 要 表现 的 数据 与 
Swift 能 接受 的 数据 之 间 的 转换 是 一 项 很 大 的 挑战 。 


外 注意 “Cocoa 字 典 数据 类 型 要 求 字典 中 的 键 是 一 个 能 哈 希 但 又 不 能 更 改 的 对 象 。Core Foundation 字 典 的 要 求 更 松 一 些 。 不 


过 ， 如 果 你 想 在 属性 列表 中 使 用 Cocoa 或 者 Cote Foundation 字 典 ， 所 有 的 键 都 必须 是 字符 串 。 


23.2 ”编辑 属性 列表 


当 你 开始 制作 Passer Rating iPhone app 的 时 候 ，Xcode 首 先 展示 的 是 应 用 程序 的 Target editor。 第 三 个 选项 卡 Info 是 一 


个 专门 用 于 Info.plist 编 辑 的 Property List 编 辑 器 ， 它 包含 了 一 个 字典 ， 向 OS 摘 述 这 个 App 将 会 如 何 显 示 。 区 域 硕 部 的 每 一 行 都 
显示 了 字典 最 项 层 的 一 个 键 值 对 。1nfo 编 辑 器 根据 经 验 将 部 分 顶级 键 (比如 说 文档 和 数据 类 型 ) 包装 到 不 同 的 便捷 图 形 编 辑 器 的 
列表 中 ， 见 图 23.1。 


1 | General Capabilities rif Build Settings Build Phases Build Rules 


PROJECT ¥ Custom OS X Application Target Properties 


内 Mac Passer Rating 


| 
1.0 
com.wt9t.$(PRODUCT_NAME:ri 
String 6.0 
String Main 
String 1 
S(EXECUTABLE_NAME) 
NSApplication 
APPL 


TARGETS Bundle versions string, short 

Mac Passer Rating Bundle identifier 

C] Mac Passer Rating Tests InfoDictionary version 
NSMainStoryboardFile 
Bundle version 
Executable file 
Principal class 
Bundle OS Type code 
loon file 
Bundle creator OS Type code 
Minimum system version 


ver? 
S(MACOSX_DEPLOYMENT_TAF 
en = 


Copyright © 2014 Fritz Anderso 
S(PRODUCT_NAME) 


Localization native development region 


Copyright (human-readable) 


aear a e o 2 ae ae ae ee ee ee a a Oa 


Bundle name 
¥ Document Types (1) 
League File 
oo, Name League File Identifier 
” Class $(PRODUCT_MOD fg Role | Editor 加 


Extensions leaguedoc Mime Types | application/octet- 


rr stream 
icon League — 
Bundle Document is dist... 


T Additional document type properties (1) 


ji 


Core Data persistent store type St SQLite 





图 23.1 ” 当 应 用 程序 项 目 创建 的 时 候 ，Xcode 将 会 显示 一 个 用 于 编辑 Info.plist 文 件 的 Target 编 辑 器 。 第 一 个 选项 卡 General 和 第 三 个 


选项 卡 Info (这 里 显示 的 ) 分 别 是 用 于 设置 应 用 程序 表现 和 行为 的 特殊 编辑 器 


当然 ， 它 仅仅 是 特殊 属性 列表 的 编辑 器 。 让 我 们 看 看 真正 的 属性 列表 编辑 器 。 在 Project 导 航 器 下 方 的 搜索 区 域 中 搜索 
plist， 导 航 器 中 剩 下 的 唯一 一 个 文件 应 该 是 Info.plist， 蛙 击 这 个 文件 。 


能 看 到 的 东西 不 多 。 它 是 Xcode 通用 的 Property List 编 辑 器 ， 仪 比 Target 编 辑 器 的 Info 选 项 卡 简单 些 。 它 有 什么 功能 ? 这 样 
做 : 在 Project 导 航 器 中 右 击 文件 名 ， 然 后 选中 Open As 一 Source Code。 现 在 编辑 区 域 将 会 显示 这 些 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" 
"http: //www.apple.com/DTDs/PropertyList-1.0.dtd"> 
<plist version="1.0"> 
<dict> 
<key>CFBundleDevelopmentRegion</key> 
<string>en</string> 
<key>CFBundleDocumentTypes</key> 
<array> 
<dict> 
<key>CFBundleTypeExtensions</key> 
<array> 
<string>leaguedoc</string> 
</array> 
<key>CFBundleTypelIconFile</key> 
<string>League</string> 
<key>CFBundleTypeMIMETypes</key> 
<array> 
<string>application/octet-stream</string> 
</array> 
<key>CFBundleTypeName</key> 
<string>League File</string> 
<key>CFBundleTypeRole</key> 
<string>Editor</string> 
<key>LSTypelIsPackage</key> 
<false/> 
<key>NSDocumentClass</key> 
<string>$ (PRODUCT_MODULE_NAME) . LeagueDocument</string> 


<key>NSPersistentStoreTypeKey</key> 
<string>SQLite</string> 
</dict> 
</array> 
<key>CFBundleExecutable</key> 
<string>$ (EXECUTABLE_NAME) </string> 
<key>CFBundleIconFile</key> 
<string></string> 
<key>CFBundleIdentifier</key> 
<string>com.wt9t.$ (PRODUCT_NAME:rfc1034identifier) </string> 
<key>CFBundleInfoDictionaryVersion</key> 
<string>6.0</string> 
<key>CFBund1eName</key> 
<string>$ (PRODUCT_NAME) </string> 
<key>CFBundlePackageType</key> 
<string>APPL</string> 
<key>CFBundleShortVersionString</key> 
<string>1.0</string> 
<key>CFBundleSignature</key> 
<string>????</string> 
<key>CFBundleVersion</key> 
<string>1</string> 
<key>LSMinimumSystemVersion</key> 


<string>$ (MACOSX_DEPLOYMENT_TARGET) </string> 
<key>NSHumanReadableCopyright</key> 
<string>Copyright © 2014 Fritz Anderson. All rights reserved.</string> 
<key>NSMainStoryboardFile</key> 
<string>Main</string> 
<key>NSPrincipalClass</key> 
<string>NSApplication</string> 
</dict> 
</plist> 


现在 ， 你 很 欣慰 地 看 到 属性 列表 的 格式 是 XML，Cocoa 用 于 编辑 .plist 文 件 的 内 置 写 入 器 对 显示 的 内 容 进行 了 很 好 的 缩 进 。 
最 顶层 的 元 素 是 <plist> ， 它 儿 须 包含 一 个 属性 列表 元 素 一 在 这 个 例子 中 是 <dict> ， 它 用 于 Info.plist 字 典 。<dict> 元 素 的 内 


容 交 蔡 显 示 <key> 字 符 串 元 素 和 属性 列表 值 元 素 。 其 中 的 一 个 键 CFBundleDocumentTypes 有 一 个 <array> 值 。 一 个 <array> 
可 能 包含 零 个 或 者 多 个 任意 类 型 的 属性 询 表 元 素 。 在 这 个 例子 中 ， 仪 有 的 <dict> 搞 述 了 Mac Passer Rating 的 文档 类 型 。 我 在 第 
22 章 中 介绍 了 Info.plist 的 键 。 


vE 这 里 有 两 个 迷惑 眼球 的 问题 。 首 先 ， 现 在 你 看 到 的 并 不 是 添加 到 应 用 程序 bundle 中 的 Info.plist 文 件 。 它 是 构建 系统 
用 来 填充 变量 和 播 入 变量 键 值 的 源 文件 ， 你 将 会 看 到 名 如 ${PRODUCT_ NAME; h RE. Hk, app bundle 中 的 Info.plist 并 不 是 


一 个 XML 文件， 它 是 一 个 binaty plist， 后 面 的 章节 中 我 将 会 介绍 它 。 


使 用 XML 格式 的 优点 在 于 它 是 标准 格式 : 正确 的 XML 会 被 任何 文件 类 型 定义 的 消费 者 接受 ， 而 不 用 管 它 的 来 源 。 由 任意 
Cocoa 应 用 程序 生成 的 .plist 文 件 与 文本 编辑 器 生成 的 .plist 文 件 一 样 。 


使 用 XML 格 式 的 缺点 在 于 它 必须 是 正确 的 。 如 果 你 志 记 关闭 一 个 元 素 或 者 错过 <dict> 列 表 中 <key> 和 值 严 格 的 交 蔡 显 示 规 
则 ， 束 无 法 从 Apple 解 析 器 中 获取 任何 内 容 。 


通常 ， 你 不 需要 担心 这 种 问题 ， 因 为 你 使 用 图 形 化 的 Property List 编 辑 器 进行 编辑 。 看 不 到 打开 和 关闭 的 标签 ， 所 以 就 不 存 
在 遗漏 标签 的 问题 。 编 辑 器 会 强制 要 求 你 对 字典 中 的 每 个 元 素 都 指定 一 个 键 ， 并 且 严 格 限制 所 能 赋予 的 数据 类 型 ， 这 样 就 大 大 简 
化 了 工作 量 。 


不 过 ， 有 的 时 候 不 方便 使 用 Property List 编 辑 器 创建 或 者 维护 属性 列表 。 让 我 们 看 看 编辑 器 是 如 何 工作 的 ， 然 后 我 将 会 介绍 
为 什么 它 不 能 处 理 所 有 任务 。 


23.2.1 属性 刘表 编辑 器 


我 们 将 要 创建 一 个 摘 述 如 何 制作 一 个 训 量 卷 的 属性 列表 。 制 作文 件 的 好 处 会 留 给 你 目 己 。 进 入 Xcode， 选 择 
File 一 New 一 File. . . (ÆN) ， 然 后 在 New File 帮 助 界 面 选 择 : OS X 一 Resource 一 Property List (在 iOS 对 应 的 帮助 界面 也 
能 找到 相同 的 文件 类 型 ) 。 如 果 现 在 一 个 项 目 正 处 于 打开 的 状态 ， 你 将 会 看 到 常规 的 保存 文件 界面 。 将 它 命 名 为 
Omelet (Xcode 会 目 动 帮 你 添加 .plist 后 级 ) 。 在 项 目 中 处 理 新 文件 的 其 他 选项 你 已 经 都 很 询 悉 了 。 


你 将 会 看 到 与 之 前 编辑 lInfo.plist 文 件 相 同 的 Property List 编 辑 器 ， 不 过 它 是 空 的， 只 有 最 顶端 的 一 行 ， 上 面 标记 为 Root。 
Property List 编 辑 器 会 让 你 生成 <dict> 或 者 <array> plists， 在 第 二 列 的 弹出 窗口 中 可 以 选择 那个 选项 。 确 保 选 中 Dictionary。 


但 是 没有 明显 的 控件 用 来 添加 任何 内 容 。 该 怎么 操作 呢 ? 这 里 有 了 两 种 万 法 。 


查看 Editor 菜 单 。 它 是 一 个 动态 的 菜单 ， 会 根据 激活 的 编辑 器 类 型 调整 对 应 的 内 容 。 现 在 编辑 器 是 Property List 编 辑 器 ， 所 
以 你 会 看 到 命令 Add Item。 选 中 这 个 选项 ， 编 辑 器 中 融会 出 现 一 个 新 行 。 


或 者 ， 将 鼠标 移动 到 Root 这 一 行 上 ， 第 一 列 融会 出 现 一 个 + 按钮 ， 单 击 它 融会 添加 一 个 新 行 ， 见 图 23.2 上 。 
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Date 
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Omelet.plist — Edited 
本 Omelet.plist > No Selection 
Type 
¥ Root Dictionary 
kb Ingredients Dictionary 
Material DO string 











Omelet.plist — Edited 
机 Omelet.plist > No Selection 


Type 
¥ Root Dictionary 


¥ ingredients Dictionary 


> Material 





图 23.2 。 (上) 选中 Editor>Add Item 就 会 在 新 属性 列表 中 插入 首 个 元 素 。 在 Type 这 一 列 选中 的 弹出 菜单 中 选择 这 行 元 素 所 代表 
的 数据 类 型 。 (中 ) 当 一 个 容器 元 素 处 于 关闭 状态 时 ， 按 下 return 键 或 者 单 击 + 按钮 就 会 插入 一 个 选中 容器 的 同 级 元 素 。 (TF) 
如 果 一 个 容器 处 于 打开 的 状态 ， 那 么 按 下 tetutn 键 或 者 单 击 + 按 钮 就 会 插入 这 个 容器 的 子 元 素 


新 行 是 一 个 字典 类 型 的 键 值 对 ， 它 市 有 一 个 key ( 键 ) ， 表 现 为 处 于 打开 待 编辑 状态 的 文本 域 ; 还 有 一 个 type (类 型 ) ， 表 
现 为 一 个 列 出 了 所 有 可 能 的 plist 类 型 的 弹出 窗口 ; 还 有 一 个 value ( 值 ) ， 如 果 是 标量 类 型 ， 那 么 这 个 值 可 以 编辑 。 


启 香 卷 菜单 分 为 3 部 分 ， 名 为 Ingredients、Material 和 Method。lngredients 应 该 是 一 个 字典 ， 其 中 Key 的 命名 为 
ingredients; 值 瓯 是 字典 本 身 ， 在 字典 中 输入 quantity 和 unit。 所 以 将 第 一 行 设置 为 Ingredients， 值 类 型 为 Dictionary， 如 图 
23.2 上 所 示 。 


你 想 要 在 菜单 中 添加 更 多 的 条 目 。 你 还 想 添 加 与 Ingredients 同 级 的 Material 和 Method 元 素 ， 还 要 添加 ingredient 字 典 作 为 
Ingredients 的 子 元 素 。 这 是 向 编辑 器 中 添加 行 时 两 种 不 同 的 风格 。 


选中 Ingredients 这 一 行 ， 按 下 return 键 (或 者 单 击 Key 这 个 单元 格 最 石 侧 的 + 按钮 ， 或 者 选中 Editor 一 Add Item) , MER 
会 生成 与 jngredients 同 级 的 Material， 将 它 的 类 型 设置 为 dictionary， 见 图 23.2 中 。 


再 次 选中 Ingredients。 在 这 个 一 行 左 侧 的 空 晶 处 ， 有 一 个 朝 右 的 提示 三 角 ， 它 表示 这 个 容器 处 于 关闭 状态 。 单 击 提示 三 角 
束 会 打开 这 个 容器 ， 但 是 不 会 有 任何 变化 ， 因 为 这 个 新 字典 还 没有 任何 可 以 显示 的 内 容 。 


现在 按 下 return， 融 会 出 现 一 个 新 行 。 但 是 这 次 新 元 素 绾 进 显示 在 Ingredients 字 典 的 内 部 (图 23.2 下 ) 。 导 致 这 种 结果 的 
原因 在 于 提示 三 角 是 处 于 打开 还 是 天 闭 的 状态 。 如 果 提 示 三 角 处 于 天 闭 的 状态 ， 那 么 按 下 return 键 融会 创建 一 个 同 级 的 元 素 。 如 
果 处 于 打开 的 状态 ， 那 么 按 下 return 键 就 会 在 容器 中 创建 一 个 子 元 素 。 


现在 Ingredients 中 已 经 有 了 一 个 子 元 素 ， 将 它 命名 为 Eggs，dictionary 类 型 。 打 开 Eggs， 按 下 return 键 (或 者 单 击 + 按 
钮 ) 两 次 ， 创 建 名 为 quantity (类 型 为 Number， 值 为 3) 和 unit (类 型 为 String， 值 为 count) 的 新 元 素 。 这 样 就 初步 完成 了 


Ingredient。 


GE 在 制作 过 程 中 出 现 了 错误 ? 那 就 像 平常 一 样 撤销 操作 。 如 果 你 想 要 删除 一 个 条 目 ， 那 么 就 选中 并 按 下 delete 键 ， 或 
者 单 击 Key 列 最 右 端 的 -按钮 。 删 除 一 个 容器 也 会 删除 容器 下 的 所 有 内 容 。 


表 23.2 Omelet P HÆ #9 Ingredients 


— 


Mushrooms Count 


Salt 


J 


Butter Ounce 








添加 更 多 与 Eggs 同 级 的 元 素 一 一 或 者 为 Ingredients 添 加 更 多 的 子 元 素 一 一 如 表 23.2 所 示 。 
完成 这 项 工作 的 方式 很 明显 ， 在 每 个 步骤 中 单 击 new-sibling 和 new-child 按 钮 ， 为 每 个 新 字典 都 设置 相同 的 unit 和 quantity 


值 。 不 过 这 样 做 很 及 烦 ， 下 面 介绍 几 种 快捷 方式 。 


. 一 旦 创建 了 你 想 要 的 字典 (Eggs) ， 那 么 单 击 容器 这 一 行 (Egg) 选中 这 个 字典 ， 然 后 选择 Edit>Copy (C) 。 当 你 粘 
贴 已 经 复制 的 行 时 ， 它 就 会 插入 一 个 新 行 ， 就 像 在 选中 行 上 单 击 了 + 按钮 一 样 。 所 以 当 Ingredients 字 典 处 于 打开 状态 的 时 候 ， 选 
中 它 ， 或 者 选中 处 于 关闭 状态 的 Eggs 这 一 行 ， 执 行 Edit_>Paste。 你 需要 修改 复制 元 素 的 key 并 更 改 unit 和 quantity 对 应 的 值 ， 但 这 已 
经 是 你 需要 做 的 最 少 的 工作 了 。 


. 当 你 完成 编辑 一 个 键 (key) RAMA (value) 的 时 候 ， 按 下 tab 键 就 会 自动 切换 到 下 一 个 可 以 编辑 的 字符 囊 。 


“ 当 一 个 文本 字段 处 于 编辑 状态 的 时 候 ， 按 下 return 键 就 会 关闭 编辑 状态 。 再 次 按 下 return 键 就 会 创建 一 个 新 元 素 ( 同 级 或 者 
FAR) ， 就 像 在 所 选 行 上 单 击 了 + 按钮 一 样 。 新 行 中 的 key 字 符 囊 (如 果 它 在 一 个 字典 中 ) RAFAH (如果 不 是 字典 ) 将 


处 于 正在 编辑 的 状态 。 初 始 类 型 会 是 一 个 字符 串 ， 如 果 一 次 性 创建 了 多 行 ， 那么 这 很 可 能 是 你 想 要 的 类 型 。 
Material 字 上 典 应 该 是 简单 的 key/string 对 ， 如 表 23.3 所 示 。Method 组 中 应 该 包含 string 类 型 ， 如 表 23.4 所 示 。 


Bowl Small Spatula Silicone, high-heat 


Fork Table fork or small whisk Egg slicer Optional, for slicing mushrooms 


Cr epe pan 10 nonstick 


表 23.4 FERMENT 





Heat pan to medium (butter foams but doesn t burn) 
Warm eggs in water to room temperature 

Slice mushrooms 

Saut in 1/4 of the butter until limp, set aside 

Break eggs into bowl, add salt 

Whisk eggs until color begins to change 

Coat pan with 1/2 the butter 

Pour eggs into pan, and tilt to spread uniformly 

When edges set, use spatula to separate from pan, then tilt liquid into gaps 
Leave undisturbed for 30 seconds 

Loosen from pan, and flip (using spatula to help) 1/3 over 
Top with mushrooms 

Slide onto plate, flipping remaining 1/3 over 


Spread remaining butter on top 


Method 中 的 字符 串 按 序 排列 非常 重要 ， 所 以 它 必 须 是 一 个 数组 。 如 果 显示 的 顺序 并 不 是 你 想 要 的 顺序 ， 那 么 可 以 按照 你 的 
需求 拖 动 这 些 条 目 ， 见 图 23.3。 


Egg Slicer String Optional, for slicing mushrooms 


7 Method VEE (4 toms 


OÒ String A Heat pan to medium (butter foams but doesn't burn) 


Warm eggs in water to room temperature 


Slice mushrooms 
Saute in 1/4 of the butter until limp, set aside 





图 23.3 ”按照 需求 拖 动 组 中 的 元 素 重 新 调整 顺序 
一 切 完成 之 后 ，Property List 编 辑 器 看 起 来 如 图 23.4 所 示 。 


在 属性 列表 中 的 查找 蔡 换 操作 与 常规 文本 文件 中 一 样 。 如 果 单 击 
Find—Findhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (¢6F) ， 就 会 显示 查找 栏 。 如 果 在 查找 栏 输 入 
butter， 那 么 容器 就 会 显示 所 有 带 有 这 个 字符 串 的 实例 。 在 查找 栏 (MARRS CRE) 单 击 左右 箭头 按钮 ， 就 能 
在 所 有 已 经 查找 到 的 行 中 切换 ， 但 是 无 法 修改 。 


如 果 你 想 要 使 用 margarine 蔡 换 butter， 那 么 选择 Find 一 Find and 
Replacehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (LEF) 就 会 在 查找 栏 中 添加 一 个 替换 行 (或 
者 ， 在 查找 栏 左 侧 的 弹出 菜单 选中 Replace 而 不 是 Find) 。 将 margarine 放 在 第 二 栏 中 ， 然 后 单 击 All 按 钮 ， 这 样 束 会 执行 全 部 蔡 
换 。 


Key 
Root 
F Ingredients 
T Eggs 
unit 
quantity 
¥ Mushrooms 
unit 
quantity 
¥ Salt 
unit 
quantity 
¥ Butter 
unit 
quantity 
¥ Parsley 
quantity 
unit 
¥ Material 
Bowl 
Fork 
Crépe Pan 
spatula 
Egg Slicer 
¥ Method 
Item O 
Item 1 
tem 2 
tem 3 
tem 4 
Item 5 
Item 6 
tem 7 
Item 8 
tem 9 
Item 10 
tem 11 
tem 12 
tem 13 


图 23.4 Property List 编 辑 


Type 


Dictionary 
Dictionary 
siring 
Number 
Dictionary 
string 
Number 
Dictionary 
string 
Number 
Dictionary 
string 
Number 
Dictionary 
Number 
string 
Dictionary 
string 
siring 
siring 
siring 
siring 
Array 
String 
siring 
siring 
siring 
siring 
siring 
siring 
siring 
string 
string 
siring 
String 
siring 
siring 


Value 


© Dictionary + (3 items) 


(5 items) 

(= items) 

count 

a 

[ items) 

count 

2 

[ items) 

pinch 

1 

(2 items) 

ounce 

2 

[ items) 

1 

sprig 

(5 items) 

small 

Table fork or small whisk 

10" nonstick 

Silicone, high-heat 

Optional, for slicing mushrooms 

(14 items) 

Warm eggs in water to room temperature 

Heat pan to medium (butter foams but doesn't burn) 
Slice mushrooms 

Saute in 1/4 of the butter until limp, set aside 
Break eggs into bowl, add salt 

Whisk eggs until color begins to change 

Coat pan with 1/2 the butter 

Pour eggs into pan, and tilt to spread uniformly 
When edges set, use spatula to separate from pan, then tilt liquid into gaps 
Leave undisturbed for 30 seconds 

Loosen from pan, and flip (using spatula to help) 1/3 over 
Top with mushrooms 

slide onto plate, flipping remaining 1/3 over 
Spread remaining butter on top 


完成 的 Omelet.plist。 你 可 以 在 单 击 提示 三 角 的 时 候 通 过 按 住 option 键 打开 或 者 关闭 字典 或 数组 
中 所 有 的 子 元 素 


Find 一 Find in Workspace/Projecthttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (TF) 也 能 正常 使 用 。 当 显示 Finder 导 航 器 的 


时 候 ， 输 入 butter， 残 会 在 匹配 列表 中 显示 对 应 的 plist。 


23.2.2 ”为 什么 不 使 用 属性 询 表 编 辑 器 


Property List 编 辑 器 生成 了 市 有 数据 的 正确 属性 询 表 ， 看 起 来 这 也 是 最 直接 的 编辑 方式 。 还 有 什么 要 六 的 呢 ? 


它 并 不 完美 。 在 Project 导 航 器 中 右 击 文件 ， 然 后 在 弹出 菜单 中 选择 Open As 一 Source Code， 这 样 融会 看 到 仓储 它 的 XML 


格式 的 plist。 


你 对 菜单 有 些 疑 问 。 如 果 添 加 一 些 修 人 


pay Be 


会 更 好 ， 


但 是 你 无 法 做 出 决定 。 所 以 在 Methods 数 组 中 添加 一 个 XML 注 释 : 


<key>Method</key> 
<array> 


<string>Slide onto plate, flipping remaining 1/3 over</string> 


<string>Spread remaining butter on top</string> 
<!-- Should I add parsley? --> 
</array> 


再 次 在 上 下 文 菜单 中 选择 Open As 一 Property List。 尝 试 在 Ingredients 字 典 中 添加 Parsley (sprig, 1) 做 出 些 改变 (你 可 
能 需要 打开 字典 ;Xcode 保存 所 有 的 打开 /销毁 状态 ， 如 果 你 更 改编 辑 器 ， 就 会 恢复 到 全 部 销毁 的 状态 ) 。 再 切换 回 Source 
Code 模 式 。 


刚 网 添加 的 注释 不 见 了 ! 如 果 你 使 用 Property List 编 辑 器 更 改 一 个 属性 列表 ， 它 束 会 销毁 所 有 不 属于 属性 列表 的 数据 。 同 
样 ， 如 果 你 需要 在 预 处 理 器 编译 Info.plist 时 候 传 递 一 些 构建 选项 ， 那 么 你 束 需 要 使 用 #includes 和 条 件 内 容 ， 如 果 通 过 Property 


List editor 传 递 这 些 措 令 ， 这 些 指令 会 消失 不 见 。 


Oza 如 果 你 将 属性 列表 视 为 常见 的 源 文 件 ， 使 用 注释 作为 笔记 或 者 注释 掉 一 些 内 容 ， 那 么 你 再 也 不 能 使 用 图 形 化 的 编 
加 器 去 编辑 它 ， 而 查看 功能 不 受 影响 。 事 实 上 ， 这 也 无 可 避免 ， 因 为 每 次 打开 这 个 文件 的 时 候 ，Xcode 就 会 将 其 中 的 内 容 显 示 在 
图 形 化 编辑 器 中 ， 但 是 不 要 更 改 。 


对 于 注释 和 预 处 理 来 况 ， 文 本 编辑 器 瓯 能 胜任 这 项 工作 。 大 型 重复 的 结构 比 XML 文 本 好 处 理 一 些 ， 处 理 程序 生成 的 文件 很 
容易 ， 也 许 你 残 想 处 理 源 文件 。 


有 一 种 方法 可 以 避免 每 次 强制 使 用 Source Code editor 进 行 编辑 。 在 Project 导 舰 器 中 选中 属性 列表 文件 ， 然 后 打开 Utilities 
Kik (使 用 工具 栏 View 控 件 右边 的 按钮 ) 。 确 保 选 中 File inspector 选 项 卡 (第 一 个 ) 。 你 将 会 看 到 这 个 文件 的 各 种 信息 和 它 在 
项 目 中 的 状态 ( 见 图 23.5 左 ) ;你 感 兴趣 的 是 Type 弹 出 菜单 中 的 设置 。 


ldentity and Type 
Name Omelat.plist 


Type | Default - Property List XML E 


Location Relative to Workspace 


../,./Uropbox/Book/AGotr/ 
sample Code/Chapter 24/ 
Omelet.plist Wa 

Full Path /Users/fritza/Dropbox/Book/ 
XAStF/ Samme Cada/ 





ee ee eee ee zz A a a ee a | 


Chapter 24/Omelet.plist + 


Source Control 


Hepository -- 
Type -- 





Current Branch -=-= 
Version =- 
status No changes 
Location 


图 23.5 ”File 查 看 器 中 文件 名 下 面 的 弹出 菜单 中 可 以 选择 编辑 器 和 Xcode 应 用 于 这 个 文件 的 语义 。 在 弹出 菜单 中 选择 Property 


List/XML 分 组 下 的 XML 而 不 是 Propetty List XML， 你 就 可 以 要 求 Xcode 总 是 使 用 XML 编 辑 器 编辑 以 .plist 为 后 级 的 文件 


这 个 弹出 菜单 的 默认 选项 是 Default 一 Property List XML。 滩 动 这 个 菜单 ( 它 束 会 迅速 向 下 滑动 ) 直到 你 找到 了 Property 
List/XML 这 个 分 组 ， 然 后 选择 XML。 


选择 完毕 之 后 ， 编 辑 器 没有 任何 变化 。 在 Project navigator 中 选择 一 个 不 同 的 文件 ， 然 后 再 回 到 Omelet.plist 中 ， 发 现 它 现 
在 按照 XML 文件 格式 显示 ， 而 且 以 后 都 会 这 样 ， 不 需要 通知 Xcode 切 换 。 


转注 总 Xcode 将 Property List XML 作为 默认 选项 ， 瞳 示 你 可 能 会 更 改 这 个 默认 选项 ， 次 次 都 使 用 纯 XML 编辑 器 ， 而 不 用 掏 


个 文件 设置 。 在 Xcode 3 中 ， 你 需要 挨个 文件 设置 。 在 Xcode 4 中 移 除 了 这 个 功能 。 


如 果 你 想 在 XML 编 辑 器 中 创建 和 编辑 属性 列表 ， 那 么 你 将 会 失去 使 用 Property List 编 辑 器 保持 语义 正确 性 的 安全 保证 。 有 
一 些 方法 可 以 减少 这 个 风险 。 


首先 ， 在 一 个 已 知 正确 的 .plist 文 件 基础 上 构建 属于 你 自己 的 .plist 文 件 。 如 果 过 程 指令 或 者 <plist> 的 轮廓 都 在 文件 中 ， 那 么 
BIL RE FSIS. 


其 次 ， 你 可 以 使 用 安 或 者 文本 编辑 器 的 术语 表 工 具 创建 一 个 文档 的 框架 ， 然 后 将 你 的 条 目 用 合适 的 标签 包围 。Bare Bone 
Software 的 BBEdit 中 有 一 个 .plist 术 语 表 就 是 用 于 这 个 目的 。 


一 旦 你 有 了 属性 列表 文件 ， 你 就 需要 知道 它 是 否 有 语法 错误 一 一 如 果 不 正 确 ， 你 束 不 能 使 用 。 检 查 语 法 错误 最 好 的 方法 就 
是 使 用 plutil 这 个 工具 。 在 Terminal 中 输入 plutilpathToPropertyList， 然 后 要 么 会 看 到 pathToPropertyList:OK， 要 么 会 看 到 指 
向 引 友 错误 的 诊断 信息 。 使 用 man plutil 查 看 详细 信息 。 


局 注意 ”最 常见 的 错误 就 是 忘记 属性 列表 XML 文件 中 的 文本 部 分 被 当做 字符 数据 处 理 ， 这 就 意味 着 < 和 & 必 须 用 &lt; 和 


&amp; 替换 。 


23.3 ”其 他 格式 


如 果 你 坚持 按照 文本 格式 编辑 属性 列表 ， 那 么 你 将 会 友 现 文 本 编辑 器 只 能 显示 和 编辑 大 部 分 属性 列表 文件 。Plist 文 件 可 能 还 
会 使 用 其 他 两 种 格式 。 其 中 一 种 也 是 文本 ， 另 外 一 种 是 二 进 制 文件 。 


23.3.1 文本 属性 列表 


Cocoa 架 构 中 的 属性 列表 来 源 于 很 早 之 前 的 一 个 框架 NeXTStep。 在 NeXTStep 中 ， 属 性 列表 被 Apple 用 名 为 legacy 的 格式 
编码 ， 因 为 使 用 这 种 格式 的 场合 非常 多 ， 所 以 你 应 该 熟悉 这 种 格式 。 仿 好 窗口 的 命令 行 接口 defaults、 编 辑 器 TextMate 的 
bundle 规 范 、 还 有 Xcode 中 的 大 量 内 部 配置 文件 ， 使 用 的 都 是 文本 格式 。 


Sis 曾经 做 过 表现 非 技 术 性 学 者 的 工作 的 App 项 目 。 有 些 人 可 能 想 让 你 为 这 些 学 者 提供 一 个 “简单 ” 的 XML 架构 ， 
这 样 就 可 以 让 机 器 读 取 其 中 的 内 容 。 假 设 数据 真 的 非常 复杂 ， 使 用 XMIL 才 是 明智 的 选择 ， 而 且 不 管 其 中 的 技术 问题 。 手 动 编码 
较 大 的 XML 对 你 我 来 说 都 已 经 很 困难 了 ; 即便 是 PhD 我 也 没 见 过 他 们 总 是 能 做 出 可 使 用 的 XML 文 件 。 结 构 化 的 文本 格式 ， 比 如 说 


传统 的 plist 或 者 JSON 才 是 合适 的 选择 。 
文本 属性 列表 只 有 两 个 主要 类 型 : string 和 data ( 表 23.5) 。 


表 23.5 文本 风格 属性 列表 的 编码 


Type Coding 
String “Two or more words” or oneWord 
Data < 466f6f 626172 > 
List ( Shirley, “Goodness and Mercy” , 1066 ) 
Associative array f key = value; “key 2 = < 332e3134313539 >;} 


字符 串 由 双 引 号 字符 包围 ， 如 果 字 符 串 中 辣 没 有 空格 ， 也 可 以 省 略 双 引号 。 数 字 、 日 期 和 布尔 值 都 必须 按照 字符 串 的 形式 仓 
储 。 读 取 数 据 的 应 用 程序 会 将 它们 转化 为 各 目 对 应 的 类 型 。 布 尔 值 的 规则 是 使 用 字符 串 YE9 和 NO。 


数据 元 素 由 尖 括 号 包围 ， 其 中 包含 十 六 进 制 数字 的 键 值 对 ， 表 示 数 据 。 数 据 流 中 的 任何 空 日 都 会 被 忽略 。 


数组 由 圆 括 号 包围 ， 它 之 间 的 元 素 用 逗号 陋 开 。 字 上 典 由 人 花 括号 包围 ，key=value 键 值 对 由 分 号 分 隔 ， 也 丈 是 说 最 后 一 个 元 素 
后 面 必 须 有 一 个 分 号 。 


23.3.2 二进制 属性 列表 


在 OS X 10.2 (Jaguar) 中 ，Apple 引 入 了 二 进 制 属性 列表 的 格式 。 二 进 制 的 plist 很 小 而 且 载 入 速度 很 快 。 默认 情况 下 程序 
生成 的 plist 是 二 进 制 格 式 ， 比 如 ，Xcode 将 Info.plists 导 出 为 二 进 制 数据 。 属 性 列表 可 以 按照 下 面 所 示 ， 使 用 plutil 将 文件 在 XML 
和 二 进 制 格式 之 间 进 行 转换 。 


plutil -convert format pathToFile 


其 中 format 要 么 是 binary1， 这 是 为 了 转化 为 二 进 制 格式 ; 要 么 是 xml1， 这 是 为 了 转化 为 XML 格式 。pathToFile 是 要 进行 
转换 的 文件 地 址 。 


De Xcode 和 BBEdit 都 会 自动 将 二 进 制 属性 列表 文件 转化 为 XML 格 式 的 文件 进行 编辑 。 
构建 设置 INFOPLIST OUTPUT FORMAT 和 和 PLIST FILE OUTPUT FORMAT 分 别 景 旨 了 Xcode 输出 Info.plist 和 其 他 plist 文 
件 的 方式 。 默 认 情况 下 ， 格 式 为 binary， 不 过 你 也 能 将 它 设 置 为 XML。 


23.3.3 JSON 


JSON 不 是 一 个 用 于 替换 的 属性 列表 格式 ， 而 是 解决 方案 的 替换 。 它 也 将 数据 按照 数组 和 字典 的 格式 组 织 。 
属性 列表 有 一 些 优点 ， 也 有 一 些 限 制 。 

: 根 对 象 不 必 是 数组 或 者 字典 。 

: 有 一 种 方法 可 以 表达 无 限 或 者 非 数字 的 值 。 

- 有 一 种 方法 可 以 区 分 整数 、 实 数 及 Boolean 值 类 型 。 


: 属性 列表 可 以 包含 NSDate， 但 是 在 JSON 中 没有 一 种 标准 的 方法 表示 上 日期。 大 多 数 开 发 者 同意 ISO8601 文 本 格式 ， 编 写 和 
解析 标准 的 日 期 格式 相当 困难 。 


- 属性 列表 可 以 包含 二 进 制 数据 作为 二 进 制 流 或 者 XML CDATA 或 者 双 层 尖 括 号 包含 的 一 部 分 。JSON 中 没有 二 进 制 数 据 的 
标准 格式 。 你 可 以 将 数据 使 用 base64 编 码 为 字符 串 并 插入 属性 列表 ,但 是 这 就 需要 你 同意 另外 一 个 应 用 程序 指定 的 转换 。 


经 过 软件 几 十 年 的 迭代 ，Apple 的 plist 代 码 的 速度 已 经 相当 快 了 。 大 多 数 JSON 的 实现 (暂时 ) 都 会 有 点 慢 ，JSONKit 是 个 
例 外 。 


进 制 plist 文 件 的 大 小 在 JSON 文 件 穷 边 〈 如 果 下 载 速度 是 一 个 需要 关心 的 内 容 ， 大 多 数 服 务 器 都 会 将 向 外 传输 的 数据 进 
行 zip 格 式 的 压缩 ， 这 样 文本 的 优势 就 很 大 了 ) 。 


Apple 的 blist 在 某 些 方面 还 达 不 到 理想 的 效果 。 
- XML F RZ, XML plist 比 实现 相同 功能 的 JSON 大 很 多 。 
` 文本 格式 只 有 少量 的 集中 数据 类 型 ， 并 且 还 受 限 于 ASCII (或 者 一 个 8 比特 的 字符 集 ， 如 果 双 方 都 同意 其 中 的 一 种 ) 。 


二 进 制 格式 比 文本 格式 和 JSON 格 式 都 要 好 一 些 ， 不 存在 解析 的 开销 ,但 是 肉眼 不 可 读 ， 所 以 无 法 调试 ， 只 能 转换 成 其 他 
格式 才能 调试 。 


- 有 一 些 库 ， 脚 本 软件 可 以 用 来 它们 创建 或 者 解析 plist， 但 是 插件 ， 尤 其 是 小 插件 有 一 些 性 能 或 者 可 读 性 问题 。 


-JSON 有 一 个 null 类 型 的 数据 值 ， 它 等 同 于 Objective-C 或 者 Swift 中 的 nil。 问 题 在 于 ，nil 不 是 一 个 对 象 一 一 如 果 你 想 要 在 一 个 
NSArray 或 者 NSDictionary 中 表示 一 个 null 值 ， 必 须要 使 用 单个 NSNull0 对 象 。 但 是 属性 列表 中 并 不 允许 使 用 NSNull 类 型 。 





.JSON 格式 有 一 个 专用 的 Internet 格 式 。 


+ 属性 列表 无 法 与 生 俱 来 地 表示 对 象 间 的 交叉 引用 (NSCoder 归 档 类 使 用 一 个 plist schema 处 理 对 象 引 用 ,但 它 是 一 个 格式 化 
的 应 用 程序 ， 而 不 是 格式 化 本 身 ) 。 


: 还 有 一 个 实际 的 问题 ，plists 只 能 由 Apple 设 备 读 取 。 跨 平台 的 应 用 程序 无 法 使 用 ， 这 也 就 意味 着 任何 客户 端 - 服 务 器 系统 
都 无 法 使 用 plist 通 信 。 


Cocoa 有 一 个 NSJSONSerialization 类 ， 它 能 将 JSON 与 Foundation 数 据 类 型 联系 在 一 起 ， 它 与 属性 列表 的 
NSPropertyListSerialization 类 似 。 它 们 两 个 都 无 法 完全 支持 你 的 数据 中 使 用 的 数据 类 型 。 有 那么 多 的 属性 列表 类 型 ， 还 有 那么 
多 的 JSJON 类 型 。 两 个 类 都 有 检查 对 象 树 的 方法 确保 它们 能 够 格式 化 。 


本 草 大 多 数 内 容 都 用 来 解释 如 何 使 用 属性 列表 存储 和 传输 数据 。 这 也 是 我 应 该 做 的 : 格式 是 Cocoa 开 上 友 的 关键， 而 且 它 也 不 
会 消失 。 但 是 ， 如 果 想 要 与 其 他 平台 交换 数据 ， 请 使 用 JSON。 


23.4 ”特殊 的 属性 列表 


cocoa 中 许多 标准 的 “文件 格式 ”都 是 市 有 构造 型 键 和 可 枚 举 值 的 简单 属性 列表 。Xcode 知 道 这 些 构造 型 键 ; 你 可 以 打开 
plist 后 为 它 指定 一 个 类 型 ， 然 后 右 击 编辑 器 视图 。 上 下 文 菜 单 中 包括 Property List Type 这 个 子 荣 单 。 如 果 Xcode 遇 到 了 构造 型 
plist， 比 如 Info.plist 或 者 一 个 1OS Setting bundle， 它 就 会 选择 常见 的 键 值 。 


一 旦 确立 了 属性 列表 类 型 ，Property List 编 辑 器 中 的 Key 这 一 列 束 会 看 作 一 个 更 活跃 的 角色 。Xcode 现 在 知道 这 个 特定 的 
plist 持 什么 键 ， 以 及 什么 类 型 适合 这 些 键 值 。 


比如 : 一 个 iOS 应 用 程序 Info.plist 会 包 合 键 UTExportedTypeDeclarations。 如 果 你 在 plist 中 添加 一 行 ， 键 这 个 栏 位 就 不 再 
是 一 个 简单 的 文本 栏 ， 而 是 一 个 组 合 区 域 ( 带 有 滑动 列表 选项 的 文本 域 ) ， 其 中 包含 Exported Type UITs 选 项 。 如 果 选 中 
它 ，Xcode 融 会 目 动 将 这 行 的 类 型 更 改 为 数组 ， 因 为 UIExportedTypeDeclarations 元 素 必 须 有 一 个 数组 值 。 


如 果 展 开 这 个 数组 ， 在 其 中 添加 一 行 ，Xcode 丈 会 创建 一 个 字典 ， 因 为 UTExported TypeDeclarations 必 须 包 含 字典 ， 里 面 
已 经 填 苑 了 这 些 字典 需要 的 3 个 键 (和 类 型 ) 。 


对 于 限制 为 标量 值 的 键 ，Xcode 将 会 为 这 个 元 素 设 置 合 适 的 类 型 ， 而 不 会 采用 可 编辑 值 的 栏 ， 值 这 一 询 将 会 包含 一 个 名 字 为 
SAAB ASS 


局 注意 ”这些 值 仍然 是 可 以 编辑 的 文本 ， 如 果 单 击 文本 区 ， 你 就 会 得 到 一 个 可 编辑 的 栏 位 。 对 于 弹出 菜单 ， 单 击 行 右边 的 


记 住 组 合 栏 是 文本 栏 ， 而 不 是 菜单 。Xcode 提 供 了 可 以 和 输入 目 定 义 值 的 地 方 。 将 键 或 者 信 视 为 可 编辑 的 文本 ， 同 时 忽略 附加 
列表 。 这 个 列表 并 非 大 而 全 或 者 有 各 种 限制 ， 如 果 一 些 需 要 的 内 容 没 有 ， 那 么 请 目 己 输入 。 


组 合 栏 列表 会 上 自动 滚动 ， 提 供与 你 的 输入 相 匹 配 的 内 容 。 这 很 方便 ,但 是 匹配 规则 大 小 写 敏感 。 如 果 没 有 找到 你 想 要 的 内 


容 ， 那 么 尝试 调整 大 小 写 后 表 重 新 输入 。 


让 你 的 键 值 拥有 与 之 相对 应 的 英文 质 述 会 让 你 从 那些 元 素 的 实际 内 容 中 隔离 ; 即使 XML 编辑 器 并 不 符合 你 的 品味 ， 你 可 能 
还 是 想 要 查看 下 文件 中 都 有 什么 。 这 里 有 两 个 策略 : 


- 打开 Utility ( 右 ) 区 域 ， 选 择 Quick Help (第 二 个 选项 卡 ) ， 然 后 单 击 其 中 一 行 。Quick Help 将 会 显示 英文 名 和 “声明 ”， 
它 是 实际 编码 后 的 键 ， 很 不 幸 都 是 英文 值 。 


- 选择 Editor 一 Show Raw Values&Keys (或 者 上 下 文 菜单 中 相同 的 命令 ) o Property List 编 辑 器 将 会 切换 到 另外 一 个 “党 
规 行为 ， 显 示 连 续 的 键 值 。 


23.5 ”小 结 


本 草 介 绍 了 属性 列表 ， 它 是 Cocoa 中 无 处 不 在 的 数据 存储 格式 。 你 已 经 看 到 了 如 何 使 用 Property List 编 辑 器 和 文本 工具 管理 
它们 。 我 也 向 你 展示 了 属性 列表 在 OS X 和 iOS 中 其 他 形式 的 显示 方法 ， 以 及 Xcode 如 何 让 目 己 适应 构造 型 格式 ， 构 造型 格式 是 广 
泛 使 用 的 特殊 plist 格 式 。 现 在 ， 你 应 该 对 这 些 概念 相当 熟悉 了 。 


第 四 部 分 Xcode 任务 集 


第 24 章 Xcode 中 的 文档 
` 第 25 章 Xcode 构建 系统 
.第 26 章 Insttuments 

第 27 章 ”调试 


` 第 28 章 ”零散 的 知识 


第 24 章 ”Xcode 中 的 文档 


开发 者 工具 和 当前 版 本 OS X 和 iO3s 文 档 的 组 合 现在 已 经 差不多 有 1.5G，Apple 还 在 持续 不 断 地 更 新 。Xcode 包 含 扩展 的 帮助 
和 文档 系统 ， 能 让 你 在 编码 的 时 候 迅 速 访问 这 些 文档 ， 它 还 市 有 一 个 浏览 器 ， 能 深入 查看 所 需 的 帮助 内 容 。 在 本 章 中 ， 我 将 会 向 
你 展示 如 何 好 好 利用 Xcode 提供 的 功能 ， 以 及 如 何 添加 属于 目 己 的 文档 。 


24.1 Quick Help 


Quick Help 是 Xcode 提供 的 功能 ， 它 能 让 你 在 尽量 减少 中 断 编码 的 情况 下 获得 APlI 信 息 。 它 的 展现 形式 轻 量 化 ， 但 是 却 很 全 
面 ， 如 果 想 要 更 深入 查看 ， 通 过 其 中 的 链接 束 能 跳 转 到 更 详细 的 信息 。 


24.1.1 Inspector 


Quick Help 可 以 始终 显示 在 每 个 编辑 器 的 永久 视图 中 。 仪 需 展 开 Utility 区 域 (工具 栏 最 右 侧 的 View 控 件 的 第 三 个 区 段 ) 
然后 选择 Quick Help 查 看 器 (第 二 个 选项 卡 ) 。 


“ 如 果 你 正在 编辑 源 人 代码， 编辑 光标 所 在 的 符号 刚好 有 对 应 的 Apple 文 档 ， 那 么 Quick Help 就 会 显示 出 方法 (举例) 如何 调 用 
的 概要 信息 ， 它 描述 了 这 个 方法 的 功能 、 参 数 的 类 型 和 用 途 ， 以 及 返回 值 。 概 要 信息 里 面 还 包括 支持 这 个 方法 所 需 的 最 低 OS 版 
本 ， 并 且 它 还 提供 了 整个 文档 的 交叉 引用 、 相 关 的 API 以 及 对 应 的 方法 在 哪个 头 文件 中 声明 。 这 些 信息 从 你 正在 使 用 的 SDK 对 应 
的 文档 集合 中 获取 ， 并 且 将 其 格式 化 以 符合 使 用 的 语言 ， 见 图 24.1 左 


D © 


Quick Help 


Declaration eee Co init(key: String, ascending: Bool) 
Returns an NSSortDescriptor object initialized with a given property key 


Description Returns an NSSortDescriptor object : l 
path and sort order, and with the default comparison selector. 


initialized with a given property key path and 
sort order, and with the default comparison 


keyPath The property key to use when performing a comparison. 
selector. 


ascending YES if the receiver specifies sorting in ascending order, 


Parameters keyPath otherwise NO. 


The property key to use when performing a 
comparison. An NSSortDescriptor object initialized with the property key path 
specified by keyPath, sort order specified by ascending, and the default 


ascending comparison selector (compare:). 


YES if the receiver specifies sorting in 


ascending order, otherwise NO. OS X (10.10 and later) 


Returns An NSSortDescriptor object initialized with 
the property key path specified by keyPath, 
sort order specified by ascending, and the 
default comparison selector (compare:). 


Availability OS X (10.10 and later) 
Related init(key:ascending:selector:) 
Declarations init(key:ascending:comparator: ) 
init() 
Show more... 


init(key:ascending:selector:) 
init(key:ascending:comparator: ) 
init() 

show more... 


Foundation 
NSSortDescriptor Class Reference 
WSSorth, striptor 
key: r 


Declared In Foundation arendings true) | 





Reference NSSortDescriptor Class Reference 
Guides Sort Descriptor Programming Topics 





图 24.1 (A) Quick Help 查 看 器 打开 且 文 本 光标 处 于 任何 有 文档 的 符号 时 ， 查 看 器 就 会 显示 符号 的 概要 信息 、 参 数 以 及 其 他 
信息 。 它 还 包括 可 单 击 的 交叉 引用 。 ( 右 ) 如 果 按 下 option 键 并 单 击 一 个 文档 化 的 符号 ，Xcode 就 会 显示 带 有 相同 信息 的 弹出 窗 


Vv 


Quick Help 还 能 应 用 于 你 目 己 的 符号 ， 不 过 只 能 显示 声明 的 引用 一 一 除非 你 为 这 些 符号 提供 了 目 己 的 文档 。 后 面 会 详细 介 


绍 。 
Ue fe Interface Builder 中 选择 了 一 个 对 象 ，Quick Help 就 会 提供 对 象 类 的 文档 信息 。 
- 在 Project/Target 编 辑 器 的 Build Settings 选 项 卡 中 选中 一 行 ， 就 会 在 Quick Help 中 看 到 该 设置 最 完整 的 文档 。 文 档 中 包括 这 个 
设置 可 能 会 如 何 获 得 默认 值 ， 以 这 个 设置 为 基础 的 构建 变量 ( 见 附录 A) 以 及 编译 器 标记 ; 如 果 有 的 话 ， 包括 设置 集合 。 


. 在 属性 列表 编辑 器 以 及 Target 编 辑 器 的 Info 选 项 卡 下 ， 如 果 Xcode 在 编辑 器 中 显示 与 英语 等 价 的 键 ，Quick Help 就 会 展示 原 


始 的 键 。 


24.1.2 ”弹出 窗口 


按 下 option 键 ， 然 后 将 鼠标 移动 到 一 个 符号 上 ， 符 号 下 面 就 会 显示 出 虚线 ， 而 且 符 号 会 蓝 色 高 亮 显 示 。 如 果 单 击 这 个 符 
号 ， 就 会 显示 一 个 弹出 窗口 ， 窗 口中 的 内 容 与 你 在 Quick Help inspector 中 看 到 的 内 容 差 不 多 ， 见 图 24.1 右 (选择 Help 一 Quick 
Help for Selected Item” 则 ?这 个 命令 也 能 完成 相同 的 操作 ) 。 


在 一 个 待 号 上 执行 Option-double-clicking ( 按 住 option 键 ,然后 双击 ) 操作 ， 残 会 显示 文档 浏览 器 ， 并 跳 转 到 这 个 符号 
对 应 的 文档 。 这 并 不 是 搜索 操作 ， 浏 览 器 中 的 搜索 设置 无 效 。 该 操作 未 通过 搜索 直接 显示 了 文档 信息 。 


代码 补 全 的 过 程 中 会 显示 一 个 简约 的 Quick Help 窗 口 。 当 弹出 代码 补 全 窗口 的 时 候 ， 单 击 其 中 一 个 选项 ， 惑 会 在 弹出 框 底 
部 看 到 几 行 关于 符号 的 描述 ， 还 有 一 个 详情 的 链接 ， 单 击 这 个 链接 就 可 以 跳 转 到 详情 页 面 
现在 ， 要 介绍 下 command-clicking ( 按 住 command 键 单 击 ) 。 
. 在 一 个 符号 上 执行 Command-clicking 操 作 就 会 打开 定义 符号 所 在 的 文件 ， 并 且 高 亮 显 示 定 义 。 搜 索 和 上 下 文 有 关 : 通 
可 能 会 有 多 个 类 实现 同一 个 方法 ， 但 是 如 果 上 下 文 能 清楚 地 分 辨 出 接受 的 对 象 类 型 ， 那 么 执行 command-click 命 令 将 会 直接 跳 转 到 


对 应 的 对 象 中 的 方法 。 如 果 上 下 文 无 法 明确 确定 应 该 跳 转 到 那个 对 象 的 方法 文通 常会 发 生 在 委托 协议 (delegate-protocol) 方 
法 中 一 一 那么 就 会 有 一 个 弹出 菜单 为 你 提供 对 应 的 选择 ， 见 图 24.2。 





if (okay) 1 
[selt. cookieParse, 


= - 


E 加- dA Deore cookieParserDiadFinish:] 


f 
M -(CookieParserDelegate cookieParserDidFinish:] 


else i 


Error error = parse | 
Search for Definitions 


NSLog( 
_PRETTY_FUNCTIOI i Show in Symbol Navigator 
self. cookieParserParseDidFail!: self error: error]: 





图 24.2 ”如 果 一 个 符号 有 多 个 定义 ， 那 么 执行 Command-clicking 操 作 就 会 出 现 一 个 弹出 菜单 ， 里 面 列 出 所 有 的 定义 ， 并 提供 在 整个 
项 目 上 执行 全 文 搜 索 的 功能 ， 或 者 在 Symbol 导航 器 中 显示 执行 command-click 的 字符 串 的 符号 


` 在 执行 command-click 操 作 的 时 候 同 时 按 下 option 键 ， 就 会 在 Assistant 编 辑 器 中 显示 对 应 的 声明 。 记 住 ， 在 执行 任何 导航 手 


势 的 时 候 按 下 option 键 就 会 让 结果 显示 在 Assistant 编 辑 器 中 。 


24.2 快速 打开 


大 多 数 为 程序 员 设 计 的 编辑 器 都 有 open-quickly (快速 打开 ) 或 者 open-selection (快速 选择 ) 命令 ， 这 个 命令 能 让 你 输 
入 一 个 文件 名 ， 然 后 编辑 器 融会 找到 并 打开 对 应 的 文件 。Xcode 的 File 一 Open 
Quicklyhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (%0) 命令 能 完成 同样 的 功能 ， 而 且 它 的 功 


能 还 远 远 不 止 这 些 。 


Open Quickly 对 话 框 中 有 一 个 搜索 栏 ， 它 会 在 项 目 能 访问 到 的 本 地 、 系 统 文 件 中 进行 增 量 搜索 。 所 有 满足 条 件 的 匹配 项 ， 
包括 目录 的 路 径 ， 都 会 出 现在 一 个 表 中 。 


还 有 更 多 功能 : 搜索 范围 扩展 到 了 符号 ， 而 不 仪 限 于 文件 名 。 输 入 components BrokenByLines， 你 就 会 看 到 匹配 项 及 它 
在 Extensions.swift 中 的 位 置 。 它 不 是 一 个 简单 的 增 量 匹配 。Apple 会 做 出 预测 ， 你 可 能 想 要 得 找 一 个 符号 或 者 文件 ， 但 是 名 字 


可 能 记 不 得 了 。 仪 需 输 入 你 还 记得 的 部 分 : 输入 bblin ， 然 后 搜索 结果 中 残 会 出 现 brokenByLines (在 其 他 元 素 之 间 ) ， 见 图 
24.3。 


M brokenByLines() 


D Mac Passer Rating + Mac Passe...ting + Utilities + Extensions.swift:39 


as Batc or LinesFeature 


We aa 
a 


OS X 10.10 + CoreServices + CarbonCore + Gestalt.h'? 


KHIDUsage_BCS gger OCSE ding SSer 


© OS X 10.10 + IOKit » hid + IOH|IDUsageTables.h: 1816 


T boundingBoxForControlGlyphAtindex:forlextContainer:p... 


oo OS X 10.10 + AppKit + NSATSTypesetter.n: 109 


bou nding BoxForCo ntrolGlyphAtindex: forTextContainer:p... 


2S A 10.10 + AppKit + NSTypesetter.h: 144 





zooM ATTRIBUTE RSA BLINDIN 


图 24.3 Open Quickly 对 话 框 会 基于 增 量 搜索 找到 项 目 中 可 访问 的 文件 和 符号 。 你 并 不 需要 记 住 完整 的 名 字 ， 你 输入 的 任何 序列 
都 可 能 与 名 字 中 的 任何 序列 相 匹配 ， 无论 字符 连贯 与 否 


24.3 ”帮助 


与 每 个 OS X 应 用 程序 一 样 ，Xcode 也 有 一 个 Help 茉 单 。 菜 单 中 的 第 一 个 选项 并 不 是 一 个 菜单 选项 ， 而 是 一 个 增 量 搜索 栏 。 
随 看 你 的 输入 ， 菜 单 中 的 内 容 融 会 被 两 部 分 中 的 内 容 蔡 换 。 


-Search 列 出 了 所 有 包含 你 输入 文字 的 菜单 选项 。 将 鼠标 放 在 列表 选项 上 ， 就 会 打开 对 应 的 菜单 并 在 条 目 旁 显示 一 个 指针 。 
单 击 列 表 项 与 选中 该 项 本 身 的 效果 一 致 。 


: 部 分 “隐藏 的 ”条 目 也 会 显示 出 来 ， 还 有 一 些 不 会 显示 。 只 有 当 你 按 下 修改 键 (打开 Navigate 菜 单 ， 执 行 按 下 和 松 开 option 
键 的 操作 ， 你 就 知道 我 的 意思 了 ) 的 时 候 才 会 显示 “Alternate (TRH) ”条 目 。 你 无 法 找到 Xcode 已 经 移 除 的 菜单 选项 ，Editor 


菜单 中 的 特定 命令 不 能 应 用 到 当前 的 编辑 器 中 。 
- Documentation and API Reference, 个 360) | 打开 Documentation 浏 览 器 。 稍 后 将 会 详细 介绍 。 
- Xcode Overview， 它 打开 包含 一 系列 介绍 Xcode 及 其 使 用 的 文章 的 浏览 器 。 


- Release Notes， 它 记录 了 Xcode 各 个 版 本 的 更 改 和 问题 概要 。Release notes 听 起 来 包含 的 内 容 不 多 , 但 是 对 于 Apple 大 多 数 技 


术 来 说 ， 这 些 说 明 的 重要 性 堪 比 “真正 的 ”文档 。 常 规 文档 中 会 告诉 你 Xcode 的 工作 方式 ， 版 本 说 明 中 将 会 告诉 你 有 什么 新 功 


能 ， 以 及 解决 之 前 出 现 的 问题 的 方法 。 


- What’ s New in Xcode， 它 列举 了 Xcode 6 各 个 发 行 版 本 的 全 部 新 特性 和 服务 ， 以 及 详细 信息 的 链接 。 它 也 链接 了 从 Xcode 
4.1 到 现在 所 有 新 特性 的 说 明文 档 。 


- Quick Help for Selected Item^ 屿 ?>， 它 与 option-clicking 操 作 的 功能 一 样 ， 为 当前 选中 的 符号 显示 带 有 Quick Help 的 弹出 窗 


- Search Documentation for Selected Text® © H /, 它 与 option-double-click 这 个 操作 的 功能 一 致 : 它 是 一 个 菜单 选项 ， 绑 定 了 快 


捷 键 ， 使 用 它 可 以 将 选中 的 内 容 对 应 的 Quick Help 显 示 在 Documentation 浏 览 器 中 。 


24.4 ”文档 窗口 


Quick Help 很 适合 仔细 研究 ， 但 是 你 也 需要 能 够 简单 阅读 文档 。 为 了 达到 这 个 目的 ， 你 需要 使 用 Documentation 济 6 


(Window 一 Documentation and API Referencef? $0) , 


Documentation 浏 览 器 由 包含 内 容 的 大 型 视图 组 成 ， 还 有 两 个 侧 边 栏 ， 使 用 工具 栏 上 的 按钮 可 以 控制 它们 的 隐藏 或 者 显 
见 图 24.4。 
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图 24.4 ” Help 浏览 器 工具 栏 中 的 按钮 显示 了 两 个 侧 边 栏 和 一 个 索引 了 文档 库 的 导航 器 ， 还 有 一 个 内 容 表 列 出 了 当前 显示 的 文档 


24.4.1 MASA 


Navigator 侧 边栏 有 两 个 选项 卡 。 第 一 个 选项 卡 用 来 展示 整个 文档 库 的 大 纲 。 从 这 可 以 进入 文档 集合 的 各 个 页 面 ， 但 是 这 里 
有 成 干 上 万 个 页 面 ， 导 航 到 类 的 树 状 图 有 5 层 之 深 。 第 一 层 或 者 前 两 层 使 用 像 Data Management 这 样 的 描述 名 称 ， 但 是 除非 你 
对 Apple 这 么 做 的 想法 心有灵犀 ， 人 否则 在 Library 导 舰 器 中 没什么 用 。 


第 二 个 选项 卡 是 Bookmark (书签 ) 导航 器 。 它 的 功能 一 目 了 然 : 文档 页 面 每 个 可 以 索引 的 部 分 ， 都 有 一 个 标签 按钮 ， 单 击 


这 个 按钮 ， 可 索引 部 分 的 名 称 和 文章 束 会 出 现在 书签 列表 中 。 单 击 书签 就 会 为 你 返回 对 应 文档 所 在 的 位 置 。 通 过 拖 动 可 以 重新 排 


列 它们 的 顺序 ， 上 下 文 菜单 可 以 让 你 删除 书签 或 者 在 新 选项 卡 中 打开 它们 。 


24.4.2” 侧 边栏 的 内 容 表 
容 表 在 文档 大 纲 视 图 中 占据 了 很 大 一 部 分 。 


第 二 列 用 来 显示 内 容 表 。Apple 的 文档 按照 books、articles 和 sections 组 织 。 
如 果 正 在 显示 的 文档 是 一 个 API 引 用 ， 那 么 大 纲 就 会 充分 利用 Apple 类 引用 的 标准 布局 ， 主 要 由 按照 任务 分 组 的 方法 列表 、 


类 方法 和 实例 万 法 组 成 。 


2443 ”类 信息 
类 参考 信息 的 另外 一 个 功能 就 是 描述 信息 的 上 部 显示 了 这 个 类 的 父 类 ， 以 及 它 实现 的 协议 、 框 架 ， 还 有 这 个 类 适用 于 哪个 
OS， 头 文件 声明 ， 并 链接 到 相关 文档 和 示例 代码 ， 如 图 24.5 所 示 。 
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图 24.5 ”类 概述 框 在 类 参考 的 顶部 ， 它 显示 了 这 个 类 的 基本 人 信息， 包含 文 档 的 引用 和 示例 代码 


当 你 查看 一 个 类 或 者 阅读 一 篇 文章 的 时 候 ， 你 可 能 想 要 浏览 其 他 没有 直接 交叉 引用 的 页 面 ， 但 是 这 些 页 面 在 同一 个 主题 下 。 
在 Library 导 航 器 中 ， 它 是 一 个 非常 实用 的 功能 : 选中 Editor 一 Reveal in Library， 查 看 带 有 打开 当前 文档 大 纲 的 Library 导 航 器 ， 
相 天 的 项 目 都 会 出 现在 当前 文档 周围 。 


2444 ”查找 和 导航 


Documentation 浏 网 器 与 网 页 浏览 器 一 样 : 它 有 一 个 搜索 栏 ， 前 进 、 后 退 按钮 标签， 选项 卡 以 及 共享 内 容 的 方法 。 


我 已 经 介绍 了 书签 ， 我 应 该 不 用 介绍 前 进 、 后 退 按 钮 的 功能 。 浏 览 器 没有 提供 常见 的 手势 : 向 左 滑动 表示 后 退 ， 疝 右 滑动 表 
示 前 进 (如 果 你 对 手势 感 兴趣 ， 它 在 System Preference 的 Trackpad 和 Mouse 面 板 可 以 设置 ) 。 


Tabs 


Command-clicking 一 个 链接 ， 就 会 在 新 标签 页 中 打开 链接 页 面 ，New Table (HT) 命令 为 你 提供 了 一 个 新 的 空 浏览 环 


境 。 拖 搜 选 项 卡 可 以 重新 排列 选项 卡 的 顺序 。 
Searching 


搜索 栏 是 你 浏览 文档 的 主要 万 去。 初级 使 用 万 法 很 信里 : 输入 要 搜索 的 条 目 ; 随 着 输入 ， 浏 哆 器 中 会 显示 一 个 下 拉 菜 日 ， 里 
面 融 是 与 输入 相 匹 配 的 文章 (图 24.6) 。 按 下 return 键 ， 束 会 选中 最 前 面 的 结果 ， 或 者 单 击 下 拉 栏 中 其 他 与 之 相 匹 配 的 选项 。 这 


是 最 理想 的 状态 。 
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图 24.6 ”在 搜索 栏 中 输入 就 会 显示 一 个 下 拉 菜 单 ， 里 面 会 显示 与 你 的 输入 相 匹配 的 文章 


如 果 你 决定 看 另外 一 篇 文章 ， 这 个 需求 很 常见 ， 因 为 根据 经 验 来 看 “选中 的 ”甚至 “最 好 的 ”匹配 项 通常 并 不 是 非常 有 用 。 
没有 办 法 恢复 提示 下 拉 框 的 内 容 ， 除 非 你 在 搜索 栏 中 删除 输入 的 最 后 一 个 字符 ， 然 后 再 重新 输入 。 


回 到 搜索 栏 ， 并 再 次 按 下 return 键 ， 就 会 得 到 了 一 个 Show All Results 的 页 面 ， 它 是 文档 搜索 中 最 有 用 的 结果 (在 建议 结果 
的 下 拉 菜 单 中 选中 Show All Results 也 能 达到 相同 的 效果 ) 。 


这 个 页 面 显 示 了 与 搜索 字符 串 相 匹配 的 所 有 文档 ， 按 照 API、SDK 总 笔 、 开 发 工具 和 示例 代码 区 分 。 下 拉 菜 单 是 一 次 性 的 ， 
全 部 结果 的 页 面 会 出 现在 浏览 器 的 历史 记录 中 。 如 果 对 一 个 结果 并 不 满意 ， 你 可 以 退回 到 全 部 结果 页 面 然后 再 次 尝试 。 同 时 , © 
包含 了 每 一 条 与 你 的 搜索 内 容 相 匹配 的 内 容 ， 而 不仅 仪 是 最 佳 猪 测 的 选择 。 下 拉 菜 单 的 唯一 优势 束 是 里 面 的 条 目 会 显示 次 级 文档 
的 标题 ， 见 图 24.7。 
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图 24.7 搜索 最 有 价值 的 就 是 全 部 结果 页 面 ， 它 列 出 了 所 有 与 之 相 匹 配 的 文章 的 标题 ， 按 照 文档 的 范围 组 织 


单 击 搜索 栏 中 的 放大 镜 按 钮 可 以 限制 搜索 结果 。 它 会 生成 一 个 弹出 框 ， 里 面包 含 仪 在 OS X 或 者 iOS 平 台 的 文档 中 搜索 的 选 
项 ; All SDKs 要 求 浏览 器 搜索 所 有 可 用 的 文档 集合 ; Automatic 选 项 可 以 根据 上 下 文 猜测 搜索 学 围 ， 比 如 项 目 窗口 中 当前 选择 的 
目标 ， 见 图 24.8。 
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A248 ” 单 击 搜索 栏 中 的 放大 镜 按 钮 就 出 现 一 个 弹出 窗口 ， 能 让 你 选择 文档 的 搜索 范围 


Export 


工具 栏 最 右 侧 的 Export 按 钮 提供 了 更 改 当前 文档 页 面 视图 的 选项 以 及 分 享 的 选项 。 你 可 为 这 个 页 面 添 标签 ， 在 Safari 中 按照 
HTML 的 格式 浏览 ， 或 者 获取 包含 当前 页 面 内 容 的 PDF 文档 ， 或 者 在 iBooks 中 阅读 。 如 果 页 面 中 附加 了 一 个 playground， 那 么 
Export KAMARE. 


还 有 另外 两 个 选项 ，Email Link 和 Message。 文 档 集合 中 的 每 个 页 面 都 能 通过 xcode URL 访 问 。 单 击 xcode 链 接 就 会 打开 
Xcode 和 Documentation 浏 览 器 ， 并 展示 相应 的 页 面 。 


Email Link 会 在 Mail.app 中 创建 一 条 包含 URL 的 邮件 消息 。Message 弹 出 窗口 中 包含 这 个 URL 和 与 Messages 应 用 程序 中 一 
样 的 接收 者 栏 。 单 击 Send 按 钮 ， 接 收 者 就 会 在 Messages 中 看 到 这 个 链接 ， 或 者 在 一 个 兼容 的 即时 消息 服务 、 一 个 SMS 文 本 中 
也 能 看 到 相同 的 内 容 。 


24.5 ”保持 同步 


Xcode 和 Apple 的 文档 友 布 时 间 表 并 不 一 致 ， 它 们 也 无 法 保持 一 致 。 即 使 让 一 个 团队 停 下 等 待 另外 一 个 团队 友 布 新 版 本 的 方 
法 可 行 ， 但 文档 仍然 是 可 扩展 和 可 修订 的 ， 并 且 做 好 了 加 公共 友 布 的 准备 ， 它 的 友 布 速度 比 开 友 复杂 的 开 友 者 工具 快 很 多 。 


当 你 第 一 次 安装 Xcode 的 时 候 ， 并 没有 安装 完整 的 本 地 文档 库 。~/Library/Developer/Shared/Documentation/DocSets 
只 是 包含 最 小 内 容 的 几 百 兆 的 主 框架 ， 其 内 容 来 自 于 developer.apple.com。 与 之 等 价 的 本 地 数据 要 大 一 个 数量 级 。 不 包含 完整 
的 文档 库 加 快 了 Xcode 的 下 载 速 度 ， 也 让 Apple 从 提供 过 期 文档 库 的 问题 中 解放 出 来 (还 有 个 解决 方法 是 每 隔 几 个 星期 束 重 新 打 
包 友 布 一 次 包含 最 新 文档 的 Xcode) 。 


Ose 在 Xcode 早 期 的 版 本 中 ， 文 档 集合 放 在 所 有 用 户 的 /Libraty/Developer/Documentation/DocSets 目 录 下 ， 在 那 之 前 ， 
一 直 都 放 在 /Developert 目 录 下 。 现 在 每 个 用 户 都 有 一 份 属于 自己 的 文档 。 


所 以 当 安 六 Xcode 完毕 的 时 候 ， 第 一 件 事 就 是 运行 Xcode， 无 论 你 是 否 需 要 。 它 束 会 立即 将 本 地 文档 与 Apple 服 务 器 上 面 的 
版 本 对 比 ， 然 后 融会 开始 下 载 干 兆 级 别 的 数据 。 


文档 由 文档 集合 提供 (docsets) ， 它 是 一 个 相当 大 的 网 站 ， 其 中 也 包含 Quick Help 的 索引 、 浏 览 大 纲 以 及 全 文 搜 索 。 每 个 
文档 集 基本 上 都 是 自 包 含 的 ， 尽 管 它 可 能 引用 网 页 外 面 的 内 容 。 


Documentation 浏 鉴 器 顶部 的 Library 导 航 器 对 应 于 当前 的 文档 集合 〈 仪 包含 当前 操作 系统 和 开发 这 工具 的 文档 ， 即 使 你 还 
安装 了 旧 的 文档 集合 


文档 集合 需要 能 够 下 载 和 (定期 ) 更 新 。 有 一 些 内 容 会 自动 下 载 ， 比 如 当前 OS 和 开发 者 工具 的 文档 ， 但 是 针对 旧 操 作 系 统 
或 者 “过 期 ”的 文档 是 可 选 的 。 你 可 以 通过 Preferences 窗 口中 Downloads 面 板 控 制 下 载 过 程 ， 见 图 24.9。 
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图 24.9 ”Preferences 窗 口中 的 Downloads 面 板 列 出 了 所 有 的 文档 集合 和 Xcode 通过 Net 安 装 或 者 更 新 的 其 他 工具 。 其 中 一 些 是 可 选 
的 ， 显 示 为 带 有 向 下 箭头 的 圆圈 和 包 大 小 


如 果 能 够 更 新 到 最 新 版 本 ，Docsets (以 及 开发 者 工具 ) 融会 显示 一 个 对 勾 还 有 一 个 下 载 (市 有 向 下 葡 头 的 圆圈 图 标 ) 的 按 
钮 。 如 果 你 选择 下 载 某 一 项 ， 它 的 状态 丈 会 奉 换 为 进度 条 ， 显 示 还 有 多 久 才 能 下 载 完 毕 。 


若 勾 选 Check for and install updates automatically 选 项 ， 会 允许 Xcode 在 你 不 方便 的 时 候 下 载 上 百 兆 的 更 新 内 容 一 一 如 
果 网 络 相对 较 慢 ， 请 不 要 义 选 这 个 选项 。 如 果 你 想 要 更 好 地 控制 这 个 流程 ， 还 有 一 个 按 需 下 载 的 Check and Install Now 按 钮 


(在 万 便 的 时 候 记 得 要 蛙 击 下 这 个 按钮 ， 因 为 更 新 很 少 会 主动 推 寺 ) 。 


在 Xcode 的 早期 版 本 中 ，Downloads 面 板 或 者 文档 本 身 会 显示 文档 包 的 位 置 、 版 本 号 及 其 他 信息 。 你 需要 根据 版 本 号 报告 
bugs， 但 是 现在 查看 器 中 自 带 一 个 浮动 的 Provide Feedback 连 接 ， 它 会 自动 将 版 本 发 送 到 Apple。 


如 果 文 档 集 根 本 没有 载 入 ， 你 仍然 需要 上 报 版 本 号 。 在 Finder 中 找到 docset 所 在 的 目录 ， 右 击 docset 的 图 标 ， 选 择 Show 
Package Contents 选 项 ， 找 到 Contents 目 录 下 的 Info.plist 文 件 ，CFBundleVersion 键 对 应 的 值 就 是 版 本 号 。 


24.6” 目 定义 的 Quick Help 
Xcode 拥有 一 个 开放 的 文档 系统 。 开 发 系统 很 多 年 前 束 一 直 使 用 在 APIl 中 设置 的 特殊 格式 的 注释 来 生成 文档 集合 。 很 多 这 类 
系统 都 源 于 JavaDoc， 最 常用 的 通用 生成 器 是 Doxygen (http:/www.doxygen.org/) ， 它 源 于 广泛 使 用 的 标记 语言 。 


Xcode 5 引入 了 一 种 向 Quick Help 添 加 你 自己 文档 的 方法 。 此 系统 依赖 于 一 个 内 置 解析 器 来 解析 HeaderDoc 格 式 下 的 注 
释 ，Apple 自 从 引进 Os X 起 就 使 用 的 这 种 注释 格式 。 同 样 的 标记 可 以 传送 给 第 三 方 文 档 集成 器 (例如 Doxygen) 用 来 友 布 你 的 
API 的 指南 ， 并 且 把 它们 安装 在 Documentation 浏 览 器 窗口 中 。 这 个 系统 在 Xcode 6 中 仍 适 用 于 C 系 列 语言 。 


但 却 不 适用 于 Swift。Xcode 无 法 识别 Swift 源 代 码 中 的 HeaderDoc 注 释 。 但 是 ， 它 能 够 识别 写 在 reStructuredText (reST) 
根子 集 下 的 文档 注释 。 相 反 ，C 系 列 语言 系统 不 识别 reST 注 释 。 没 有 集成 器 来 编译 独立 的 参考 指南 。 


Wis teSttuctufedText 是 一 个 简单 的 标记 语言 ， 它 可 以 生成 富 文本 文档 ， 并 且 文 档 的 内 容 还 是 可 读 的 。 它 最 初 用 来 生成 
Python 文 档 。 可 以 在 http://docutils.sourceforge.net/docs/user/rst/quickref.html 中 找到 这 个 语言 的 概述 。 使 用 reST 最 简单 的 方法 是 通 


过 Python 的 pip 包 管理 器 安装 restview 包 (你 必须 先 安装 pip， 同 时 记 住 使 用 sudo) o 


这 种 状况 至 少 要 持续 到 Xcode 6.2。 公 平地 襄 ， 有 这 种 特性 的 “文档 ” 仅 有 上 友 行 襄 明 中 的 一 句 话 ， 或 者 某 个 博 主 和 Apple 工 
程 师 之 间 随 意 的 一 次 谈话 。 虽 然 这 个 扩 术 对 于 满足 Quick Help 的 各 种 目 来 说 已 经 足够 好 ， 但 是 Apple 并 没有 推荐 这 种 方法 ， 也 没 
有 声明 它 已 经 可 使 用 了 。 当 你 读 到 这 本 书 的 时 候 这 种 状况 一 定 会 改善 。 


WE 注意 我 的 “权威 ”资源 来 自 NSHipster 的 博客 http://nshipster.com/swift-documentation/。 


24.6.1 C 语 言 系 列 的 文档 

这 次 我 将 要 讨论 适用 于 C 语 言 系 列 代 码 的 技术 ， 也 让 你 们 为 期 待 中 的 基于 reST 系 统 的 功能 做 好 准备 。 
如 何 生 成 Quick Help 

如 果 知道 如 何 编写 文档 注释 (下 一 章 将 会 介绍 ) ， 那 通过 Xcode 将 它们 集合 到 Quick Help 中 非常 简单 。 


下 面 是 -[SimpleCSVFile run:error:] 在 代码 中 的 声明 ， 客 户 端 代 码 可 以 访问 唯一 的 SimpleCSVFile。 


[kx 
Parse the CSV file. 
Loops through the lines of the input file, interpreting the first line 


as unique keys for the data fields contained in the remaining lines. 


The keys and values for each line are gathered into an NSDictionary, 
which is presented line-by-line through the supplied block. 


It is an error for the file to have a line with a different number of 


fields than specified in the header line. 


@bug The parser does not handle quoted or escaped fields at all. 


@param block 


A block the caller supplies to accept 


record-by-record data from the receiver. 


@param[out] error A pointer to an NSError 
LE meor =nil. 
return value of NO ) ， 


problem. 


@return YES if parsing succeeded. 
@return “NO” if it did not. If an “NSError«*’ 
was supplied, x*error 
*/ 
(BOOL) run: (SimpleCSVRecordBlock) block 


error: (NSError **) error; 


注释 由 /* 开 头 ， 表 示 这 是 文档 ， 后 面 跟 着 一 句 话 的 概述 
[SimpleCSVFile run:error:] 的 参数 和 返回 值 都 会 被 特殊 标记 。 


你 不 用 做 任何 其 他 工作 。option-click 任 何 地 方 出 现 的 -[SimpleCSVFile run:error]， 你 都 会 
的 格式 与 任何 Apple SDK 符 号 的 Quick Help 中 显示 的 内 容 格 式 一 致 ， 


h) SimpleCSvFile.h >) R -runserror: 


4 5) Mac Passer Rating > 1 Model 
jf Fe 
Parse the CSV file. 
Loops through the lines of the input file, interpreting the first line 
as unigue keys for the data fields contained in the remaining lines. 


The keys and values for each line are gathered into an NSDictionary, 


which is presented line-by-line to the caller through the supplied block. 


It is an error for the file to have a line with a different number of 
fields than specified in the header line. 
@bug The parser does not handle quoted or escaped fields at all. 
param block A block the caller Supplies to accept 
record-by-record data from the receiver. 
G@param[out] error A pointer to an ‘NSError’ object pointer, or nil. 
If non-nil, and an error occurs (signified by a 
return value of *‘NO‘), ‘*error"® will describe the 
problem. 
@return YES" if parsing succeeded. 
return "NO" if it did not. If an ‘NSError**" parameter 
was supplied, ‘*error* will describe the problem. 
*/ 
= (BOOL) run: (SimpleCSVRecordBl 
error: (NSError *#) error; 


k) block 


图 24.10 ”option-click 任 何 带 有 文档 注释 的 符号 ， 人 


object pointer, 
and an error occurs 
`xerror ` 


述 ， 这 人 句 话 将 会 


or nil, 


(signified by a 


will describe the 


parameter 
will describe the problem. 


见 图 24.10。 


Quick Help 


Declaration 


Description 


Parameters 


Returns 


Declared In 


显示 在 API 率 引 的 最 顶层 。 接 下 来 是 


几 长 的 摘 述 ， 


得 到 一 个 弹出 窗口 ， 里 面 内 容 


一 (BOOL)run:(__strong 
SimpleCSVRecordBlock) block 

error: (NSError *__autoreleasing 
*)error; 
Parse the CSV file. Loops through the lines of the input file, 
interpreting the first line as unique keys for the data fields 
contained in the remaining lines. 
The keys and values for each line are gathered into an 
NSDictionary, which is presented line-by-line to the caller 
through the supplied block. 
It is an error for the file to have a line with a different number 
of fields than specified in the header line. 
Bug: The parser does not handle quoted or escaped fields at 
all. 
block 


A Block the caller supplies to accept record-by-record data 
from the receiver. 


error[out] 

A pointer to an NSError object pointer, or nil. if non-nil, and 
an error occurs (signified by a return value of NO’), “error 
will describe the problem. 

‘YES if parsing succeeded. 

‘NO’ if it did not. If an ‘NSError**” parameter was supplied, 
“error will describe the problem. 

Simple-sV¥File.A 





尔 都 会 看 到 一 个 带 有 格式 化 内 容 的 弹出 窗口 。Xcode 不 会 处 理 文档 中 的 标 


记 ，Xcode 不 会 解析 文档 中 的 风格 标记 。 对 比 这 段 注 释 与 图 24.14 Swift 中 相同 方法 的 teSttuctutedText 注 释 


Target 编 辑 器 的 Build Setting 选 


卡 包含 关于 Documentation Comments2 


告 的 设置 。 当 你 将 它 切换 到 局 用 ，clang 将 会 


为 你 提供 一 个 代码 正确 性 的 实时 性 评 售 ， 比 如 注释 中 的 参数 名 字 是 否 与 声明 中 的 参数 名 字 一 致 。 


文档 ; 


Xcode 的 帮助 分 析 器 能 够 计 


只 别 一 套 人 简洁 的 标记 符号 ， 它 们 用 来 表示 注释 的 仿 义 ， 比 如 参数 、 


回 值 和 特别 注意 。 


示 记 关键 字 


以 @ 或 者 \ 开 头 。 


: @param。 第 一 个 词 是 参数 名 称 ; 后 面 跟 的 内 容 是 对 它 的 描述 。 注 释 中 可 以 有 多 个 @param 指 令 。 如 果 @param 后 面 带 有 [in]、 
[out] 或 者 [inout]， 那 么 相应 的 注释 将 会 把 它们 标记 为 仅 用 于 输入 、 仅 用 于 输出 (因为 它 可 能 是 指向 NSErrot 的 指针 ) ， 或 者 既 可 以 
作为 输入 也 可 以 作为 输出 。 


-tetutn。 描 述 了 函数 /方法 的 返回 值 。 


- (Qexception。 第 一 个 词 是 一 个 水 数 或 者 方法 可 能 抛 出 的 异常 名 称 ， 剩 下 的 内 容 是 对 它 的 描述 。 可 以 有 多 个 @exception。 仅 


适用 于 Doxygen。 
- (@bug。 为 API 中 的 bug 添 加 注释 。 
- (@todo。 表 示 API 中 将 要 完成 的 功能 。 
- @watning。 在 空白 处 显示 为 带 有 红 条 的 文本 。 
 (@deprecated。 标 记 一 个 API 已 经 过 期 ， 后面 带 有 你 的 注释 。 
- @see。Doxygen 将 会 链接 的 外 部 URL 或 者 内 部 符号 。 
 (@author。 代 码 作 者 的 名 字 、URL 或 者 邮件 地 址 。 如 果 提 供 了 邮箱 地 址 ， 记 得 在 @ 后 面 添 加 一 个 \ 符 号 。 
` (@c，(@p。 表 示 code 或 者 parameter 文 本 的 单个 字符 。 在 HTML 标 记 中 将 会 扩展 为 多 个 字符 。 
. @em，(@e，@i。 要 被 设置 为 印刷 体 的 单个 字符 。 
. @b。 需 要 设置 为 黑体 的 单词 。 


字符 风格 的 标记 很 难 读 写 。Doxygen 支 持 Mardown 风 格 的 标记 ， 所 以 代码 符号 可 以 显示 为 'symbol' 而 不 是 @c symbol, m 
且 ，Markdown 符 号 还 能 应 用 到 段落 中 ， 而 不 仪 仪 是 单词 。 若 不 使 用 Markdown，Doxygen 还 接受 使 用 HTML 标 记 段 落 。 
Xcode 会 自动 忽略 HTML 中 的 标记 符号 。 


Xcode 不 会 为 Quick Help 解 析 Markdown， 所 以 你 不 得 不 在 表现 与 易于 理解 和 书写 之 间 做 出 选择 ， 显 示 效 果 既 不 能 大 差 ， 
也 要 让 Quick Help 能 够 表达 你 的 想法 。 对 于 我 来 说 ， 我 倾向 于 使 用 Markdown。 


24.6.2 Doxygen 


Doxygen (http://www.doxygen.org/) 是 一 个 非常 强大 的 系统 。 它 有 一 个 庞大 的 标签 库 ， 能 够 生成 详细 的 帮助 系统 ， 里 
面 还 可 以 市 有 可 单 击 的 链接 、 继 承 图 、 索 引 和 搜索 功能 。 它 面向 的 语言 多 种 多 样 ， 比 如 Objective-C、Java 和 FORTRAN。 它 能 
生成 HTML、LATEX、Docbook、Xcode 文 档 集合 等 。 多 种 多 样 的 标签 和 配置 选项 会 让 人 感到 困惑 ， 但 是 一 旦 你 决定 了 要 使 用 的 
子 集 ， 玖 不 需要 考虑 其 他 ， 只 需要 专心 写 文 档 。 为 此 我 们 值得 付出 一 些 汗水 ， 见 图 24.11。 


-(BOOL) run: (SimpleCSVRecordBlock) block 


error: (NSError **) error 


Parse the CS¥ file. 


Loopa through the Enes of the input file, intarpreting the first line as unique keys for the data fields contained in tha 
ramaning lines. 


Tha keys And Values for gach line are gathered into an AS Dictionary, Which is prasaniad lirne-biy-line io fhe caller 
through fhe supplioc block 


itis an error for the fila to have a line with a differant number of fields than Specified in the header line. 


Parameters 
block A block the caller supplies to accept record-by-record data from the receiver. 
[out] error A pointer to an NHSError object pointer, or nil. if non-nil, and an error occurs (signified by a 
return Value of WO), *error will describe the problem. 


Returns 
YES if parsing succeeded. 


NÖ if it did not. If an NSError** parameter was supplied, *error will describe the problem. 


Here iS ihe callar graph tor thes funcion: 


FU Er p 


Property Documentation 
| 





图 24.11 Doxygen 将 本 章 开 始 的 r-[SimpleCSVFilerun:error:] 显 示 为 交叉 引用 和 可 索引 的 HTML 


本 书 不 会 介绍 Doxygen 提 供 的 所 有 标记 和 选项 。 如 果 需 要 了 解 更 多 内 容 ， 请 浏览 http:www.doxygen.org/ 手 册 ， 或 者 下 载 
当前 版 本 的 PDF。 


准备 工作 
首先 要 做 的 是 下 载 Doxygen。 进 入 Doxygen 的 网 站 ， 选 择 Downloads 一 Sources&Binaries， 找 到 最 新 版 本 的 .dgm， 下 
载 ， 载 入 硬盘 镜像 ， 然 后 将 Doxygen app 拖 到 /Application 目 录 中 。 


我 建议 你 安装 命令 行 图 形 工具 GraphViz 包 。Doxygen 可 以 使 用 它 生成 类 和 继承 图 。Homebrew 包 管理 器 让 这 一 切 变 得 十 分 
SA, 


如 果 你 还 未 安装 Homebrew， 请 先 安 装 。 进 入 http://brew.sh， 复 制 页 面 上 的 ruby 命 令 ， 并 把 它 粘 贴 到 Terminal 中 。 此 处 的 文 
档 会 帮助 你 解决 一 些 麻 烦 ， 如 果 你 已 在 /ust/local 目 录 下 安装 一 些 东 西 ，brew 可 能 让 你 想 想 已 安装 的 东西 。 你 应 该 不 需要 使 用 sudo 
令 。 如 果 发 生 了 一 个 权限 相关 的 错误 ， 回 到 Homebrew 网 站 去 寻找 问题 解决 方案 。 


ə 


- 输入 brew update， 确 保 下 载 和 构建 的 包 都 有 最 新 的 配置 。 


- 输入 brew install graphviz。Graphviz 工 具 将 会 被 安装 在 usr/local/Cellar/graphviz/version/bin/ 中 。 输 入 
s/usr/local/Cellar/graphviz 米 找到 实际 的 版 本 号 。 


配置 Doxygen: 基本 设置 


AAG 
命令 行 


工具 ， 它 会 根据 配置 文件 对 你 的 源 代码 进行 处 理 。OS X 中 的 Doxygen app 基 本 上 残 是 配置 


Doxygen proper 是 一 个 


编辑 器 。 汉 击 Doxygen 瓯 能 


\—4 


运行 。 


Oz 4| 入 Gatekeepet 后 的 3 年 ， 默 认 的 安全 协定 拒绝 运行 那些 还 未 使 用 Mac Developer Program (Mac 开 发 者 计划 ) 成 
名 的 应 用 ，Doxygen 还 未 签名 。 如 果 你 正在 使 用 Gatekeeper (你 应 该 在 使 用 ) ，Findet 将 会 阻止 你 运行 Doxygen。 为 了 规避 这 一 
点 ， 右 击 Doxygen 应 用 图 标 ， 选 择 Open， 并 单 击 随 后 弹出 的 警告 框 中 的 Open。 


NS 


你 将 会 看 到 一 个 “向 导 ” 窗 口 ， 这 个 窗口 的 左 半 边 是 一 个 视图 列表 ， 右 边 是 一 个 表格 ， 见 图 24.12。 


© Doxygen GUI frontend + (/Users/tritza/Dropbox/Book/AbStr/sample Code/Doxytile) 


step 1: Specify the working directory from which doxygen will run 


{Usersitritza/Dropbox/Book/X6StF/Sample Code Select... 


step 2: Configure doxygen using the Wizard and/or Expert tab, then switch to the Run tab to generate the documentation 


Topics 


Provide some information about the project you are documenting 


Projectname: Passer Rating iOS 


Diagrams 


Project synopsis: (iOS demo project for Xcode 6 Start to Finish 


Project version or id: | 1.0 


Project logo: Select... 


Specify the directory to scan for source code 
Source code directory: Passer Rating 


P) Scan recursively 


Specify the directory where doxygen should put the generated documentation 


Destination directory: ./docs Select... 


Previous 





图 24.12 ” Doxygen 命令 行 工具 被 包装 为 一 个 图 形 化 的 “向 导 , RAR A ACR CH 


N/a 


Doxygen 作 为 一 个 UNIX 命 令 行 工具 ， 它 需要 一 个 工作 目录 。 你 首先 要 做 的 就 是 使 用 窗口 顶部 的 功能 指定 一 个 工作 目录 ， 其 
中 有 一 个 输入 文件 夹 路 径 的 文本 框 ， 而 不 是 使 用 Select... 按 钮 选择 Passer Rating 项 目 目录 ， 因 为 Select 按 钮 选择 的 是 包含 项 目 文 
件 的 文件 夹 ， 而 不 是 包含 源 代码 的 文件 夹 。 


现在 让 我 们 填写 配置 文件 。 分 为 两 步 : Wizard 选 项 卡 显示 的 是 严 广 界面， 你 可 以 用 它 完成 大 多 数 安 六 工作 ;然后 束 可 以 将 


它 从 Expert 选 项 卡 中 移 除 ，Expert 标 等 页 仪 仪 是 一 个 用 于 配置 文件 的 结构 化 编辑 器 。 
针对 iOS Passer Rating 的 Objective-C 


Oza Doxygen (目前 ) 可 作用 于 很 多 语言 ， 但 是 〈 目 前 ) Swift 不 在 其 中 。 这 些 步骤 是 


版 本 而 言 的 。 


项 目 面板 





项 目 面板 指向 Doxygen 的 源 文件 和 目标 目录 ， 并 接受 项 目 沁 围 内 的 设置 ， 比 如 标题 和 |logo。 
* Project name Passer Rating iOS. 


Project synopsis 





Passer Rating 项 目 功能 的 简单 介绍 : 


?| 一 此。 
Project version or id 





10S demo project for Xcode 6 Start to Finish. 
1.0 O 


如 果 你 提供 了 logo 图 片 ， 那 要 记 住 : 它 在 文档 的 每 个 页 面 中 都 是 按照 全 尺寸 大 小 显示 的 。 如 果 图 片 太 大 ， 页 面 头 部 就 会 太 
大 。 在 Passet Rating 中 我 使 用 60 X60 的 图 标 。 


- Source code directory 





Doxygen 工 作 的 时 候 会 浏览 整 
Ko A Scan recutrsively 选 项 ， 让 它 能 够 也 人 遍历 子 目录 。 


- Destination directory 





个 源 文件 ， 解 析 并 对 它们 进行 索引 。 使 用 Select 选 择 项 目的 源 文 件 目 


36 + Choose 4-4. 6 


它 是 文档 的 生成 目录 。 不 要 将 这 个 目录 指向 源 代 码 所 在 目录 ; 卷 入 版 本 控制 会 让 问题 变 得 复杂 
模式 面板 


单 击 Select 按 钮 ， 在 选择 文件 的 对 话 框 中 ， 选 择 项 目 目 录 ， 然 后 单 击 New Foldetr， 输 入 一 个 名 字 ， 如 docs。 选 择 这 个 新 目录 ， 然 后 


Mode 面 板 粗 略 指定 了 Doxygen 如 何 解析 源 代码 文件 。 
对 于 期 望 的 提取 模式 ， 选 


择 All Entities, Doxygen 将 会 为 所 有 的 方法 
们 提供 注释 。 在 产品 项 目 中 ， 你 可 能 想 
何 显示 它们 。 


个 


着 量 、 销 数 等 都 生成 对 应 的 文档 ， 即 使 你 没有 为 它 
re 


要 过 滤 一 些 不 放 到 文档 中 的 注释 ， 但 是 对 于 这 个 demo， 我 们 很 乐意 借 此 看 看 Doxygen 如 


你 还 会 被 询问 是 否 要 “优化 ”项 目 语言 。 没 有 提供 针对 Objective-C 的 优化 ， 但 是 有 一 个 单 选 按钮 组 ， 你 需要 从 中 选择 一 
不 用 管 这 个 选项 ， 在 Expert 选 项 卡 下 处 理 它 。 
输出 面板 


Doxygen 能 生成 5 种 格式 的 文档 ， 或 者 其 中 任何 一 种 文档 。 勾 选 HTML,，with navigation panel 和 With search function, 
Change color 按 钮 为 你 提供 了 色彩 、 饱 和 度 和 值 滑 块 ， 用 来 委 避 文 档 页 面 ， 根 据 目 己 的 喜好 设置 即 可 。 
Diagrams 面 板 


选择 Use dot tool from the GraphViz package， 然 后 愉快 地 勾 选 所 有 可 用 的 图 形 
设置 


ZAI, 


b 


如 果 你 想 看 下 现在 导出 的 文档 效果 ， 可 以 进入 Run 选 项 卡 ， 运 行 Doxygen， 然 后 让 它 为 你 显示 结果 (但 是 你 还 没有 告诉 
到 哪里 去 寻找 GraphViz， 所 以 回 到 Diagram 面 板 ， 选 择 一 


其 他 选项 ) 。 不 过 为 了 效果 更 好 ， 你 可 以 使 用 Expert 选 项 卡 。 
为 了 满足 多 种 多 样 的 需求 和 品位 ，Doxygen 提 供 了 多 种 选项 ， 可 以 在 从 网 站 上 下 载 的 手册 中 查找 到 选项 的 说 明 。 这 些 选 


项 


都 在 Expert 选 项 下 中 。 你 需要 更 改 的 仪 有 几 个 选项 ， 但 是 这 几 个 选项 的 更 改 并 不 简单 : 高 级 选项 中 有 17 个 面板 ， 部 分 面板 中 的 
选项 非 单 多 。 选 项 按照 相 天 元 素 的 顺序 排 询 ， 但 是 并 不 容易 看 明日 顺序 是 什么 。 你 需要 挨个 查看 这 些 选项 ， 看 哪些 是 你 需要 的 。 


Expert 选 项 卡 将 每 个 设置 都 用 配置 文件 中 键 值 对 里 面 的 名 字 标 记 。 如 果 将 鼠标 放 到 一 个 名 字 的 上 面 ， 顽 下 方 的 文本 域 中 残 会 
显示 相应 的 解释 。 每 个 设置 都 有 一 个 与 其 数据 类 型 相 匹 配 的 编辑 器 。 标 签 为 黑色 的 设置 表示 它 的 值 为 默认 值 ， 当 友 生 更 改 之 后 ， 
这 个 值 融会 变 为 红色 。 


Project 面 板 


勾 选 JAVADOC AUTOBRIEF (列表 的 中 部 ) 来 模拟 JavaDoc 的 特性 ， 文 档 块 的 第 一 句 话 是 总 结 表格 形式 的 简短 描述 。 如 果 
不 勾 选 这 个 选项 ， 束 需要 使 用 @brief 来 做 这 个 简短 的 摘 述 。 


在 Wizard 选 项 下 的 Mode 面 板 中 ， 你 被 强制 要 求 选 择 “ 优 化 ”这 个 选项 展示 特定 语言 的 AP1， 这 上 举 语 言 中 不 包含 Objective- 
C。 你 需要 撤销 这 个 操作 ， 方法 是 : 定位 底部 列表 旁边 所 有 的 
OPTIMIZE OUTPUT FORhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/.. 选 项 ， 然 后 不 要 勾 选 它们 。 


Doxygen 会 根据 源 文 件 后 缀 来 推断 源 代码 的 语言 ， 所 以 当 它 解析 .m 文 件 时 ， 它 会 认为 这 是 Objective-C 文 件 。.h 文 件 的 合 义 
模 校 两 可 ， 很 多 项 目 中 都 包含 .h 文 件 。 在 EXTENSION_MAPPING 表 中 添加 一 行 消 除 这 种 模糊 性 : 在 文本 框 中 输入 h=Objective- 
C， 然 后 蛙 击 + 按钮 。 


HTML 面 板 


HTML 面 板 控 制 Doxygen 生 成 的 HTML 格 式 。 在 这 里 ， 你 可 以 将 Doxygen 设 置 成 将 你 的 文档 索引 成 二 Xcode 一 样 的 形式 。 


- GENERATE _ DOCSET 是 主要 的 设置 ， 义 选 它 。 








-DOCSET_FREEDNAME 为 一 组 文档 集合 设置 名 字 。 你 现在 构建 的 集合 用 于 iOS Passer Rating app， 但 它 可 能 也 是 Xcode 6 
g app 


Start to Finish 文 档 集合 的 一 部 分 。 将 它 设 置 为 Xcode 6 Start to Finish. 


-DOCSET BUNDLE_ID 是 这 个 集合 的 唯一 标识 。 它 设置 为 文档 集合 Info.plist 的 bundle 标 识 符 。 我 将 它 设置 为 


com.wt9t.x6sf.docs.ios 。 
- DOCSET PUBLISHER_ID， 它 作为 这 个 和 其 他 文档 集合 的 父 字 符 串 。 我 使 用 com.wt9tx6sfdocs。 


- DOCSET PUBLISHER_NAME 是 你 用 来 展示 给 别人 看 的 名 字 。 我 填 的 是 Ftitz Anderson. 
Dot 面 板 
将 DOT PATH 设置 为 /usVlocal/bin。 


Oz 如 果 安 装 了 之 前 版 本 的 GraphViz 和 Doxygen， 你 会 发 现 dot 可 能 想 从 X11 的 包 中 提取 一 些 工 具 。 因 为 Doxygen 对 于 项 
目 中 的 每 个 @intetrface 和 文件 都 会 执行 dot 程 序 一 到 两 次 ， 它 将 会 生成 很 多 个 X11 App 的 实例 。 因 为 你 很 可 能 没有 在 Mac 上 安装 
X11， 所 以 每 个 实例 都 会 等 待 你 授权 安装 X11 库 。 我 们 不 想 看 到 这 一 点 。 当 前 GraphViz 安 装 器 中 的 工具 无 法 解决 这 个 问题 ， 所 以 
请 输入 /usr/local/bin。 


24.6.3 ”运行 Doxygen 


你 已 经 创建 了 一 个 可 以 重复 使 用 的 配置 文件 ， 所 以 应 该 保存 它 。 选 择 File 一 Save (36S) 。 默 认 的 文件 名 为 Doxyfile， 这 个 
名 字 不 错 ， 不 用 更 改 它 。 我 建议 将 这 个 文件 放 在 合适 的 工作 目录 中 ， 也 融 是 包含 Passer Rating.xcodeproj 的 目录 。 


最 后 ， 你 已 经 做 好 了 生成 文档 的 准备 。 选 择 Run 选 项 卡 ， 单 击 Run doxygen。 文 本 区 域 中 将 会 填 满 运行 日 志 ， 有 瞬间 就 会 变 
得 很 长 。 如 果 你 将 dot 作 为 图 形 生 成 器 ， 还 有 大 量 的 图 形 类 型 ， 部 分 dot 进 程 可 能 要 持续 很 久 。 


当 遇 到 格式 错误 的 时 候 ，Doxygen 工 具 也 不 会 停止 ， 即 使 问题 很 多 也 不 会 停 。 确 保 人 至少 浏览 一 下 错误 信息 。 第 一 次 运行 可 
能 伦 费 大 量 的 时 | 间 ， 但 是 Doxygen 有 一 个 优点 束 是 不 会 重复 生成 结构 没有 发 生变 化 的 图 形 。 


当 处 理 完毕 的 时 候 ， 单 击 Show HTML output， 机 器 上 的 默认 浏览 器 就 会 打开 生成 文档 (你 指定 的 生成 文件 夹 下 htm| 子 文 
件 夹 中 的 index.html) 的 根 页 面 。 


这 个 文件 应 该 是 main 或 者 概述 页 面 ， 如 果 你 没有 指定 ， 这 个 页 面 默认 融会 为 空 ， 上 面 有 一 个 导航 条 。 单 击 这 个 导航 条 融会 
显示 更 多 内 容 : 类 和 成 员 的 索引 ; 文件 机 器 内 容 ; to-do 和 bugs。 如 果 你 在 Doxygen 中 寻找 一 个 客户 端的 查找 界面 ， 每 个 页 面 
都 会 包含 一 个 搜索 域 ， 它 将 会 对 整个 文档 集合 执行 递增 搜索 。 


9 注意 ”Docs 目 录 的 内 容 都 是 导出 数据 。 你 应 该 将 这 个 目录 添加 到 版 本 控制 系 统 中 ， 正 好 借 此 机 会 把 docs/ 添 加 到 .oitignore 
文档 中 。 
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当 你 设置 了 GENERATE_DOCSET，Doxygen 惑 会 添加 一 个 Makefile， 它 将 会 使 用 make 命 令 将 文档 集合 安装 到 
~/Library/Developer/Shared/Documentation/DocSets，Xcode 会 找到 这 个 目录 。 在 Terminal 中 ， 将 工作 目录 设置 为 生成 
HTML 的 目录 ， 然 后 运行 make 命 令 。 

$ # Assuming you're in the project directory: 


$ cd docs/html 
$ make install 


Output from make 


$ 


wits 不 要 使 用 sudo 来 运行 make。 没 有 这 个 必要 ， 为 你 已 经 对 Library/Developet 目 录 有 了 写 入 的 权利 ， 而且 你 已 经 创建 
了 所 有 权 是 troot 的 目录 和 文件 ， 所 以 无 法 再 更 改 或 者 删除 。 


退出 并 重新 打开 Documentation 浏 览 器 ， 你 的 文档 集合 应 该 显示 在 Library navigator 的 大 纲 栏 中 ， 大 纲 可 以 浏览 这 个 集合 
中 的 全 部 索引 。 单 击 其 中 的 一 个 索引 ， 浏 览 器 将 会 显示 对 应 的 页 面 。 内 容 边 栏 表 基本 上 也 会 正常 工作 一 一 当 你 进入 一 个 类 的 引 
用 页 的 时 候 ， 它 将 会 按照 你 希望 的 那样 填充 ， 但 是 单 击 其 中 一 项 ， 就 会 清除 表 中 的 内 容 ， 显 示 选 项 对 应 的 内 容 ， 见 图 24.13。 


Documentation — Passer Rating iOS: SimpleCSVFile Class Reference 


[x] i] a 


NSMapplingModal Class Refarance Passer Rating iOS: SimplaCsVFila Class Reference 


„Mh 网 nitWithPath: 

PRPasseriD 

» | 加 PRPasserListController headers The receiver. 
b> [D| PRPasserListControllert) mog 
» [D| PRPasserRelationships path 


run :error: Returns 


©) SimpleCsvFile -(BOOL) run: (SimpleCSVRecordBlock) block 
initWithPath: 


al FURS: 


回 | headers 
F| moc : 
- ae Parse the CSV file. 
j izl Simplet SvFilaj 
| Class index 
| Class Hierarchy 


error: (NSError **) error 


Loops through the lines of the input file, interpreting the first line as unique keys for the data 








fields contained in the remaining lines. 


图 24.13 ”Doxygen 生 成 的 http 目 录 下 的 makefile 文 件 将 会 安装 你 的 文档 ， 这 样 Xcode Documentation 浏 览 器 就 能 查看 这 个 文档 





Ore Doxygen 有 个 缺憾 就 是 它 的 技术 和 格式 没有 专门 针对 Objective-C 进 行 定制 ; 很 难 最 小 化 它 的 C++ 约定 。 还 有 一 些 其 
他 选择 ， 它 们 能 制作 与 Apple 自 身 文档 风格 一 致 的 文档 。Apple 的 HeaserDoc 由 Xcode 工具 提供 ， 它 很 容易 生成 一 系列 HTML 文 档 

一 一 只 需要 一 些 命令 行 工具 和 自 定 义 的 模板 文件 。 然 后 ， 自 从 你 想 要 生成 一 个 文档 集合 的 时 候 ， 事 情 就 会 迅速 变 得 复杂 ， 你 将 不 
得 不 为 了 部 分 索引 而 手写 代码 。 搜 索 这 个 工具 HeaderDoc 获 得 更 多 信息 。AppDoc，http://gentlebytes.com 是 一 个 开源 的 生成 器 ， 

能 生成 文档 集合 。 它 不 如 Doxygen 成 熟 ， 同 时 AppDoc 狭 窄 的 关注 面 让 配置 系统 从 概念 上 看 没有 那么 复杂 了 ， 缺 乏 图 形 化 的 编辑 


器 让 人 很 难 接 受 。 


24.7 9wWlIft 和 reqStructuredText 











LINA 





用 户 从 Swift 代码 中 生成 文档 的 过 程 很 简单 。 当 我 撰写 本 书 皮 明 它 能 快 点 改变 
Quick Help 提 供 内 容 。 这 项 工作 它 完成 得 非常 好 ， 仪 增加 了 少量 空间 ， 但 是 它 不 支持 生成 汇总 的 参考 文档 ， 就 像 你 从 Doxygen 
或 HeaderDoc 中 获得 的 那样 。 


/ 


jah 公平 地 说 ， 在 Swift 之 前 这 与 Apple 的 政策 没有 什么 不 同 : Xcode 本 身 不 负责 生成 参考 文档 (HeaderDoc 具 备 这 个 功 
能 ， 但 它 是 NeXT 上 自己 生成 文档 那个 时 期 的 产物 ) 。 问 题 不 在 于 Apple 不 提供 一 个 文档 聚合 器 ; 那 是 因为 迄今 为 止 ， 还 没有 谁 这 人 么 
做 过 。 


Swift 的 文档 注释 使 用 restructuredText 标 记 语言 书写 ， 它 们 以 一 个 双星 的 注释 块 
(/**http://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/...*/) 或 是 退行 的 3 条 冬 线 (///) 开始 。 


reStructuredText 有 丰富 的 语法 ， 可 用 来 布局 文本 、 应 用 样式 以 及 交叉 引用 ， 但 是 Xcode 仅 提供 了 Quick Help 能 够 泻 染 的 


最 /| \ 语 法 集合 Fo 


` 正文 文本 ,很 显然 。 没 有 格式 标记 ，URL 是 纯 文本 。 上 段落 必须 在 源 文 本 的 左边 界 开始 ( 
思 ) ， 除 非 你 主动 缩 进 。 我 不 建议 你 缩 进 ， 因 为 通常 Quick Look 查 看 器 都 很 窜 ， 这 将 使 得 缩 进 的 文本 很 局 促 。 


分 项 列表 (项 目 符号 ) 。 在 左边 界 以 一 个 合适 的 项 目 符号 (例如 * 或 者 -) 作为 一 行 的 开头 。 连 续 的 项 之 间 不 需要 空 行 。 子 


表 的 每 一 项 之 前 应 当 有 一 定 的 距离 ， 但 是 记 住 限制 宽度 并 尽 可 能 缩减 距离 。 


“ 枚 举 列表 。 以 一 个 数字 或 字母 后 跟 一 个 多 号 〈 也 接受 其 他 分 隔 符 ) 来 作为 每 一 项 的 开头 。 改 变 枚 举 或 项 目 符号 格式 会 引入 


一 个 子 表 ， 但 是 6.2 版 本 的 解释 器 无 法 解析 它 。 不 用 管 枚 举 器 的 值 ， 每 一 项 将 会 连续 编号 
( “Lhttp://www.hzcourse.com/tesoutce/readBook? 
path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..http://www.hzcoutse.com/tesoutce/teadBook? 
path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..4.° 会 显示 
A “thttp://www.hzcourse.com/tesoutce/readBook? 
path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..http://www.hzcoutse.com/tesoutce/teadBook? 


path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/..2.” \ 


` 字段 列表 。 每 个 字段 由 一 个 被 冒号 括 起 来 的 关键 字 开 始 (例如 ，: “returns: ”) ,文本 将 被 格式 化 为 帮助 的 一 部 分 。 只 


有 两 个 标签 得 到 了 特殊 处 理 : 


“: parm: ”表示 一 个 函数 的 参数 。 每 个 参数 使 用 一 个 。 命 令 符 后 的 第 一 个 单词 将 被 设置 为 等 宽 字 体 (monospaced 


font) ， 跟 着 的 文本 将 会 出 现在 下 一 行 。 所 有 的 “: parm: ”被 合并 成 单独 的 Parameters 小 节 。 


Ci retum: ” 表示 一 个 函数 的 返回 值 。 文 本 的 任何 部 分 都 没有 特殊 处 理 。 可 以 有 多 个 返回 值 ， 这 一 点 很 有 用 因为 你 经 
第 想 要 调用 特殊 的 返回 值 ， 就 像 : 


Returns the index of the item in the Array 
nil of no item is found 


-ZA “i return: ”字句 被 合并 成 单独 的 Returns 小 节 。 

其 他 的 字段 列表 都 是 公认 的 ， 但 没有 给 予 特殊 处 理 让 它们 在 Quick Help 展 示 中 有 自己 专属 的 显示 部 分 。 写 下 
:bug: The parser does not handle quoted field values. 

将 在 描述 部 分 放置 一 个 带 有 标签 是 缩 进 的 段落 ， 见 图 24.14。 


Quick Help 对 于 文档 注释 “left margin (AWA) ”的 想法 会 让 你 一 半 的 文档 明显 随意 地 缩 进 ， 但 是 一 旦 了 解 了 原理 你 就 
会 明日 这 是 有 意义 的 。 注 释 块 最 少 缩 进 的 一 行 决定 了 “左边 界 。”/// 注 释 最 容易 完成 这 个 目的 : 如 果 所 有 文本 距离 该 行 最 后 一 
个 科 杠 有 两 个 (或 一 个 ,或 3 个 ) 空格 ， 帮 助 文本 束 呈 现 为 左边 对 齐 。 如 果 任何 文本 距离 最 后 一 个 冬 杜 多 出 一 个 空格 ， 它 将 会 被 
缩 进 ; 如 果 少 了 一 个 空格 ， 它 将 决定 左边 界 ， 并 且 其 他 所 有 的 文本 将 会 被 缩 进 。 


一 个 注释 块 的 左边 界 是 从 每 一 行 的 开始 算 起 。 最 少 缩 进 的 注释 行 成 为 帮助 文本 中 最 少 缩 进 的 段落 。 如 果 你 有 一 段 文本 以 /** 
开头 ， 那 该 文本 与 第 二 个 星 号 乙 间 的 距离 残 是 它 的 边 距 。 


> | |& Mac Passer Rating > P1 M. > Pa u..> D SimpleCSvFile.swift > R runt: 


/// Present the records in the CSV file as a dictionary of | Quick Help 

header/field pairs. Declaration public func run(block: ([String 
fff : String]) -> NSError?) -> 
/// The caller provides a closure that takes the records one at CSsVError? 


a time and processes them. Description Present the records in the CSV file as a 
Jif dictionary of header/field pairs. 


//f If the closure cannot handle the record, it may return an The caller provides a closure that takes the 
NSError describing the problem, upon which the method will poor GINE NI A ee ee ee 


immediately return a .ClientError wrapping the NSError. if the closure cannot handle the record, it 
may return an NSError describing the 


Mf | problem, upon which the method will 
//f The method does not examine the client-generated NSError. immediately return a .ClientError wrapping 


hf the NSError. 

/// bug: The parser does not attempt to handle quoted or The method does not examine the client- 
escaped field values. generated NSError. 

ttf 

/// tparam: block A closure taking a String-to-String The parser does not attempt to 
Dictionary and returning an NSError if the closure detects handle quoted or escaped field 
an error values. 


jit returns: CSVError.ClientError if the closure returned an 
NSError Parameters block 

A closure taking a String-to-String 

Dictionary and returning an NSError if the 

closure detects an error 


bug 


A returns: Any other CSVError if the receiver detects a file 
or format error 
Afi rreturns! nil if the file was parsed without error Returns CSVError.ClientError if the closure returned 
public an NSError 
= j 了 四 可 s 7 - = 3 
func run(block: ([String: String]) -> NsError: Any other CSVeError if the receiver detects a 
) -> CSVError? file or format error 


i _ nil if the file was parsed without error 
if let error = prepareToRun() 1 return error + Declared In SimpleCSVFile.swift 



































图 24.14 teSttuctutedText 注 释 会 为 Swift 的 定义 附加 Quick Help 文 档 ， 它 的 效果 与 Objective-C 中 HeaderDoc 注 释 的 效果 一 样 好 。 图 中 
的 方法 与 图 24.10 中 的 方法 一 样 


更 多 的 讲解 也 不 及 你 杀手 试 试 。 


语文 本 标记 ， 比 如 斜体 或 者 等 宽 字 体 文本 ， 人 在 Quick Help 中 会 原样 显示 。 与 之 类 似 的 还 有 了 段 藻 标题、 表格 、 图 片 ….. 如 果 它 
不 在 此 列表 中 ， 它 也 不 会 出 现在 Quick Help 上 。 这 与 处 理 C 系 列 语言 注释 的 方法 没有 不 同 。 


24.8 小 结 

本 章 带 你 深入 了 解 了 Xcode 的 文档 系统 。 你 已 经 看 到 如 何 使 用 Quick Help 立 即 获得 API、lnterface Builder 对 象 、 构 建设 置 
的 指引 文档 ， 以 及 如 何 快速 访问 声明 的 方法 和 代码 中 的 其 他 符号 。 

我 向 你 展示 了 Documentation 浏 览 器 ， 如 何 使 用 它 浏览 及 查找 对 应 的 文档 。 你 已 经 学 习 了 如 何 管理 并 更 新 你 的 文档 集合 。 


你 已 经 了 解 了 为 目 己 的 代码 生成 Quick Help 多 么 简单 : 在 你 的 声明 中 添加 审 有 标准 标记 语言 的 注释 ， 而 且 你 也 完成 了 这 个 
工作 。 如 果 出 现 语法 错误 ，clang 甚 至 会 友 出 警告 。 


最 后 ， 我 介绍 了 Doxygen， 它 是 生成 全 面 、 索 引 化 、 可 搜索 的 文档 集合 的 系统 。Doxygen 应 该 能 生成 并 安装 文档 集合 ， 你 
可 以 在 Xcode 的 Documentation 浏 览 器 中 查看 这 些 文 档 。 同 时 ， 我 也 向 你 展示 了 它 是 如 何 工 作 的 。 不 玉 的 是 ， 现 在 它 还 不 支持 
Xcode 6。 


S258 Xcode 构建 系统 


如 果 你 习惯 使 用 UNIX 工 具 ,， 例 如 make 构 建 软件 ， 那 么 你 很 有 可 能 不 相信 1DE 束 像 Xcode。 在 makefile 文 档 中 ， 你 可 以 直接 
设置 编译 选项 ， 其 至 指定 每 个 文件 的 编译 规则 。 你 可 以 指定 构建 依赖 ， 所 以 一 个 头 文 件 的 更 改 可 能 会 强制 要 求 重新 编译 依赖 它 的 
文件 ，clang 甚 至 有 一 个 模式 用 来 生成 依赖 树 。 


乍 一 看 ，Xcode 没 有 给 你 像 make 这 样 的 控制 权 。 它 是 “神秘 的 ”， 昌 然 你 为 在 用 尸 面前 保持 神秘 让 你 感到 很 目 宫 ， 但 是 你 
并 不 相信 Xcode 的 这 种 神秘 。 


本 章 的 目标 是 揭 开 Xcode 构 建 系统 的 神秘 面纱 。 即 使 你 并 不 是 一 个 基于 使 用 make 软 件 构建 项 目的 老手 ， 你 也 会 更 明日 
Xcode 所 做 的 工作 以 及 如 何 控 制 它 。 


25.1 Xcode 如 何 组 织 构 建 过 程 


Makefile 文 件 是 按照 目标 层次 结构 组 织 的 。 有 一 些 目 标 ， 比 如 频繁 使 用 的 clean 或 者 install target 是 抽象 的 ， 但 是 绝 大 部 分 
都 是 文件 。 与 每 个 目标 相关 联 的 是 它 所 依赖 的 前 置 目标 的 列表 ， 以 及 一 个 用 来 将 父 目 标 转 为 为 满足 目标 的 脚本 。 通 常 ， 前 置 文件 
用 于 生成 目标 文件 的 输入 文件 。Make 的 核心 在 于 如 果 任 何 目标 的 修改 早 于 前 置 文件 的 修改 时 间 ， 它 们 就 会 使 用 当前 的 文件 ， 而 
不 需要 再 次 运行 生成 产品 的 脚本 。 依 赖 树 和 剪 枝 规 则 的 组 合 让 make 程 序 成 为 强大 和 高 效 的 工具 ， 适 用 于 自动 化 的 任务 ， 比 如 说 
构建 软件 产品 。 


makefile 的 组 织 单 元 是 target-dependency-action 组 。 但 是 在 应 用 程序 的 开 友 中 ， 这 个 组 通常 一 成 不 变 ， 你 甚至 不 用 配 
置 ，make 提 供 了 默认 的 规则 。 比 如 : 


%. O0 : %.C 


$(CC) -c $(CPPFLAGS) $(CFLAGS) -o $@ $< 


所 以 程序 员 需 要 做 的 就 是 列 出 项 目 中 所 有 的 .0 文件 ， 以 及 构建 规则 将 会 生成 的 所 需要 的 .0 文件 。 通 常 ， 维 护 makefile 文 件 的 
任务 ， 融 变 为 维护 依赖 和 关系 而 不 是 文件 列表 。 


同样 ，Xcode 让 依赖 分 析 变 为 清单 列表 维护 ， 它 会 充分 利用 项 目的 目标 是 指定 类 型 的 可 执行 产品 ， 比 如 应 用 程序 、 库 、 工 具 
或 者 插件 。 了 解构 建 过 程 ，Xcode 融 能 利用 项 目 中 的 文件 完成 正确 的 工作 。 


Xcode 工 作 空 间 中 的 一 个 文件 属于 3 个 不 同 的 列表 。 


Projects。 一 个 文件 会 出 现在 它 所 在 项 目的 Project 导 航 器 中 。 这 与 它 对 项 目 中 的 任何 严 品 是 否 有 作用 没关系 。 比 如 ， 它 可 
能 是 用 来 参考 的 文档 ， 或 者 你 做 的 一 些 笔记 。 如 果 你 正在 工作 空间 中 工作 ， 一 个 文件 可 能 在 工作 空间 中 而 不 在 任何 项 目 中 。 做 到 
这 一 点 最 简单 的 万 法 束 是 确保 没有 项 目 被 选中 (command-click 取 消 项 目的 选择 状态 ) ， 然 后 选择 File 一 Add Files 
tohttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... (CA) 。 


局 注意 更 确切 地 说 ， 没 有 文件 “处 于 ”项 目 或 者 工作 空间 中 ， 项目 和 工作 空间 保持 对 文件 的 引用 。 如 果 一 个 项 目的 输入 
内 容 是 将 项 目 所 在 文件 夹 中 的 文件 按照 树 形 结构 组 织 ， 那 么 会 让 文件 记录 和 构建 过 程 变 得 简单 。 但 是 如 果 文 件 既 在 项 目 中 也 在 工 
作 空间 中 ， 那 么 它 也 会 在 目录 树 中 。 项 目 知 道 文件 在 哪里 。 


Targets。 一 个 文件 可 能 属于 项 目 中 的 零 个 或 者 多 个 target。 如 果 一 个 文件 处 于 target 的 文件 列表 中 ， 那 么 这 个 文件 束 属 于 
产品 的 一 部 分 ， 无 论 这 个 文件 是 源 代码 文件 还 是 要 复制 到 产品 中 的 资源 。 当 一 个 文件 被 添加 到 产品 中 的 时 候 ，Xcode 会 询问 你 这 
个 文件 属于 项 目 中 的 哪个 target。 你 也 可 以 通过 在 File 查 看 器 中 选择 这 个 文件 所 属 的 target， 或 者 将 它 拖 到 Target 编 辑 器 的 构建 
阶段 的 方法 来 添加 文件 。 


一 个 target 等 同 于 组 成 文件 的 集合 。 基 于 Release 或 者 Debug 配 置 的 构建 没有 在 单个 target 中 包含 或 者 排除 文件 的 概念 。 如 
果 需 要 区 分 文件 集合 ， 那 就 需要 为 每 个 文件 集合 都 创建 一 个 独立 的 target。 一 个 文件 可 以 属于 多 个 target， 你 可 以 为 每 个 target 
设置 预 处 理 宏 。 这 就 意味 着 两 个 target 能 共享 它们 的 配置 。 本 章 后 面 介绍 的 .xcconfig 文 件 ， 让 共享 变 得 很 简单 。 


Build Phases。Target 中 文件 所 处 的 角色 依赖 于 这 个 文件 所 属 的 phase。 当 一 个 文件 添加 到 target 中 的 时 候 ，Xcode 会 根据 
文件 类 型 为 它 指 定 一 个 构建 阶段 : 带 有 clang 或 者 Swift 编译 后 缀 的 文件 会 被 指向 Compile Sources 这 个 阶段 ; 库 文 件 属 于 Link 
Binary With Libraries 阶 段 ;， 大 多 数 其 他 文件 属于 Copy Bundle Resources 阶 段 ， 见 图 25.1。 


构建 阶段 的 执行 顺序 依赖 于 它们 在 Target 编 辑 器 中 显示 的 顺序 。 一 般 情 况 下 你 会 想 让 Compile Sources 阶 段 早 于 Link 
Binary With Libraries 阶 段 处 理 完成 ， 因 为 后 面 这 个 阶段 需要 前 面 这 个 阶段 的 产品 ， 事 实 也 是 这 样 。 但 是 你 可 以 将 这 几 个 阶段 按 
照 你 想 要 的 顺序 拖 动 。 


当 你 通过 创建 一 个 Xcode 项 目 或 者 在 已 经 创建 的 项 目 中 添加 一 个 新 的 target 的 方式 得 到 了 一 个 新 的 target， 就 指定 了 你 想 要 
生成 的 产品 类 型 ， 你 将 无 法 更 改 产品 类 型 除了 创建 另外 一 个 target。target 类 型 构成 了 一 个 锚 点 一 一 终点 一 一 Xcode 构 建 的 系统 
依赖 分 析 中 会 使 用 这 个 概念 : 它 会 告诉 构建 系统 产品 想 要 的 结构 (单个 文件 还 是 包 ) ， 以 及 如 何 链接 为 可 执行 程序 。 





Y Target Dependencies (0 items) 


Add target dependencies here 


二 


Y Compile Sources (15 items) x 
Compiler Flags 
"m Passer_Rating.xcdatamodeld ...in Passer Rating 
» AppDelegate.swift ...in Passer Rating 
a Game.swift ...in Passer Rating/mogenerated 
> PasserEditController.swift ...in Passer Rating 


a PasserListController.swift ...in Passer Rating 


» SimpleCSVFile.swift ...in Passer Rating 
a StatView.swift ...in Passer Rating 
» rating.swift ...in Passer Rating 
Passer.swift ...in Passer Rating/mogenerated 
a PasserEditTableController.swift ...in Passer Rating 
» Extensions.swift ...in Passer Rating 


> Passer.swift ...in Passer Rating/mogenerated 
a Utilities.swift ...in Passer Rating 
Game.swift ...in Passer Rating/mogenerated 


i ameListController.swift ...in Passer Rating 
G ListControll ft P Ratinc 


Y Link Binary With Libraries (2 items) 


Name Status 

Eb | 3 | < pi 
=] MapKit.framework Required $ 
国 NetworkExtension.framework Required ^ 
+ Drag to reorder frameworks 


Y Generate Test Data 


Shell /bin/sh 
Jusr/bin/ruby "SiSRCROOT?"/Passer\ Rating/generate- 
games.rb > "$$ SRCROOT}"/Passer\ Rating/sample- 
data.csv 


Show environment variables in build log 


Run script only when installing 


input Files 
$(SRCROOT)/Passer Rating/generate-games.rb 


+ 


Output Files 
${SRCROOT}/Passer Rating/sample-data.csv 


十 


Y Copy Bundle Resources (3 items) 


€| sample-data.csv ...in Passer Rating 
Main.storyboard 


Images.xcassets ...in Passer Rating 


十 





图 25.1 正常 项 目的 构建 阶段 。 通 过 在 Project 导 航 器 中 选择 想 要 查看 的 项 目 ， 单 击 一 个 target， 然 后 再 在 Target 编 辑 器 中 选择 
Build Phases 选 项 卡 就 能 访问 构建 阶段 。 这 个 阶段 按照 表 的 形式 表示 ， 展 开 就 能 看 到 属于 它 的 文件 。 在 一 个 阶段 中 添加 一 个 文件 的 


方法 就 是 将 它 拖 到 这 个 阶段 的 表 中 


构建 系统 的 另外 一 个 锚 点 就 是 target 构 建 阶段 成 员 的 集合 。Compile Sources 构 建 阶段 ， 连 同 你 添加 的 源 文件 ， 包 括 对 象 文 
件 ， 它 们 是 所 选 target 类 型 链接 阶段 的 输入 内 容 。 各 种 各 样 的 文件 复制 阶段 ， 以 及 为 各 个 阶段 提供 的 文件 是 复制 命令 需要 使 用 的 
文件 ， 这 些 文件 构成 了 应 用 程序 的 基本 结构 。 


开发 者 为 makefile 指 定 了 显 式 依赖 和 默认 规则 ，Xcode 通 过 推断 完成 对 应 的 工作 : 它 决定 了 如 何 使 用 新 文件 生成 一 个 产品 ， 
以 及 这 个 过 程 如 何 完成 。 即 使 你 使 用 一 个 target 的 产品 构建 另外 一 个 target，Xcode 也 会 检测 到 其 中 的 依赖 关系 ， 并 将 依赖 的 
target 的 构建 过 程 集合 到 目标 target 的 构建 过 程 中 。Xcode 需 要 做 的 就 是 将 两 个 target 放 到 同一 个 工作 空间 中 ， 它 们 甚至 不 需 
放 在 同一 个 项 目 中 。 


25.2 ”构建 变量 


.Cc 文 件 默 认 的 make 规 则 基本 上 将 整个 操作 都 概括 了 。C 编 译 器 的 命令 和 一 系列 需要 传输 的 标记 都 存在 于 makefile 的 变量 
CC、CPPFLAGS 和 CFLAGS 中 。 在 文件 的 头 部 设置 合适 的 标记 ， 以 及 构建 规则 中 所 有 的 编译 参数 。 


Xcode 同样 依赖 于 变量 来 组 织 构建 参数 ， 但 是 粒度 非常 细 。 比 如 ， 变 量 GCC ENABLE CPP RTTI 控 制 clang 是 否 要 添加 - 
fno-rtti， 从 而 限制 C+ + 运行 时 类 型 信息 的 生成 。 这 个 变量 通过 Target 编 辑 器 下 Build Settings 选 项 卡 中 的 一 个 弹出 窗口 设置 
( “Enable C++Runtime Types” ) ， 见 图 25.2。 
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Kernel Development Mode 


T Apple LLVM 6.0 - Language - C++ 
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kb Enable C++ Runtime Types 





图 25.2 ”Target 编 辑 器 Build Settings 选 项 卡 下 面 设置 列表 中 的 选项 非常 多 ， 你 可 以 通过 在 搜索 栏 中 输入 相关 的 参数 取得 选项 。 输 入 
tiA WAPI RRASB, RK FC++A HAA EYRE. Utility A P A Quick Help 解 释 了 每 条 设置 的 作用 ， 包 括 相 
关 构 建 变 量 的 名 字 信 息 以 及 它 设 置 的 编译 器 标记 


让 我 们 看 下 Build Settings 选 项 卡 。 在 Project 导 航 器 中 选择 一 个 项 目 ，Project/Target 编 辑 器 束 会 显示 在 Editor 区 域 ， 然 后 
选择 一 个 target。 蛙 击 Build se 。 在 选项 卡 栏 的 右 侧 ， 你 会 看 到 两 对 按钮 : Basic/All 和 Combined/Levels。Basic 将 
列表 包含 的 内 容 缩小 为 一 些 经 常 使 用 的 基本 元 素 。 稍 后 我 将 会 介绍 组 合 和 按 等 级 显示 的 区 别 。 现 在 ,最 和 直接 的 显示 方式 是 All 和 和 


Combined, 


这 个 列表 包含 了 Xcode 为 这 个 target 提 供 的 大 部 分 构建 变量 。 如 果 打 开 Utility 区 域 (View 控 件 右手 边 的 区 域 ) ， 选 中 Quick 
Help (第 二 个 ) 查看 器 ， 歼 能 看 到 所 选 字符 串 的 描述 。 在 摘 述 结尾 的 括号 中 ， 是 这 一 项 控制 的 构建 变量 的 名 字 和 | 编译 器 选项 
标签 和 描述 都 是 可 以 搜索 的 。 在 列表 顶部 的 搜索 栏 中 输入 rtti， 束 会 将 图 25.2 的 列表 中 的 内 容 缩 减 为 两 项 。 


全 注意 为 部 分 源 代码 文件 使 用 手动 生成 的 makefile 提 供 自 定义 的 编译 器 选项 非常 常见 。Xcode 构 建 系 统 也 允许 这 么 做 。 在 
Build Phase 选 项 卡 中 ，Compile Sources phase 表 还 有 第 二 列 Compiler Flags。 双 击 这 一 列 中 的 条 目 ， 就 能 得 到 一 个 弹出 编辑 器 ， 用 于 
编辑 这 个 文件 额外 的 标记 。 你 无 法 从 Quick Help 中 得 到 你 输入 的 信息 对 应 的 帮助 ， 但 是 你 可 以 查看 Build Settings 列 表 ， 看 看 哪些 
选项 可 以 使 用 。 你 输入 的 内 容 将 会 被 添加 到 编译 这 个 文件 的 标记 中 一 一 它 无 法 重 写 通用 的 设置 ， 也 不 能 针对 不 同 的 配置 为 每 个 文 
件 单独 设置 标记 。 


25.3 ”设置 的 层级 
Build Settings 选 项 卡 中 的 Combined 设 置 列表 是 应 用 于 正在 构建 的 目标 的 标记 和 指令 的 列表 。 不 过 ，Xcode 构 建 系统 也 提 
供 了 一 些 比 这 些 设 置 更 强大 的 控制 。 组 合 列表 中 的 设置 来 自 于 6 层 设置 。 
. BSD 环 境 变量 
- Xcode 自己 的 默认 值 
“ 整个 项 目 当 前 的 配置 
当前 target 的 配置 
: 如 果 使 用 xcodebuild 命 令 行 工具 ， 那 么 也 包括 其 中 的 命令 行 参 数 
添加 到 每 个 文件 上 的 编译 选项 


图 25.3 解 释 了 这 个 层级 的 工作 方式 。 
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图 25.3 Xcode 和 xcodebuild 构 建设 置 的 层级 。 一 个 设置 可 能 在 多 个 层级 中 出 现 , 但 是 最 上 面 的 设置 拥有 最 终 的 控制 权 。 上 层 中 的 
设置 可 能 会 通过 $finhetited} 引 用 下 层 中 的 设置 。 最 上 层 命令 行 设置 只 会 出 现在 xcodebuild 调 用 中 


你 将 会 经 常 更 改 target 和 project 设 置 ， 而 很 少 会 更 改 其 他 设置 。 项 目 级 别 允许 你 设置 项 目 中 每 个 target 的 策略 一 一 比如 
root SDK 或 者 你 想 要 看 到 的 警告 一 一 所 以 一 个 地 方 的 更 改 会 影响 所 有 相关 的 位 置 。 你 仍然 可 以 在 通用 设置 中 移 除 一 个 产品 ， 只 


需要 将 可 蔡 换 的 设置 放 在 target 中 : 这 个 target 中 的 设置 将 会 履 兰 project 中 的 设置 。 


等 级 


下 一 


记 住 上 面 这 些 内 容 ， 单 击 Build Setting 选 项 卡 (图 25.4) 下 面 工具 条 中 的 Levels 按 钮 ， 见 图 24.5。Target editor 现 在 就 会 在 
每 行 中 显示 为 4 列 ， 分 别 为 项 目 默认 设置 、project 设 置 、target 设 置 以 及 net 设 置 ， 这 些 值 会 影响 这 个 target 的 实际 设置 。 你 仅 
能 编辑 其 中 target 和 project 这 两 列 的 值 。Levels 中 有 效 设 置 的 值 用 绿色 显示 。 


|S) Passer Rating 
General Capabilities auilid Settings Build Phases Bulld Rules 


PAOJECT Baale | ll | Combined | Lavals | | 


- 
Passar Matin s 
aoe ee F Apple LLVM 6.0 - Code Generation 


TARGETS 
Passar Rating Debug Information Level 

LJ Passer Mating Tests Enable Additional Vector Extensions 
Enforce Strict Aliasing 
Gonearate Desug Symbok 
hota Pooltion-Dopandent Coda 
Generate Test Coverage Files 
Inline Meihods Hidden 
Inetrument Program Fina 
Kernel Development Mode 
Link-Time Optimization 
Make Strings Read-Only 
No Common Blocks 


页 Optimization Laval Multiple values <Multiple valuee> > “Multiple values> + 
Debu Nome [-00 None [-00] > Nome [-00] = 
a | 
Relssss Fastest, Smallest [-Os 





图 25.4 ”选中 Levels 视 图 ，Target Editor 显 示 了 每 个 级 别 如 何 影响 用 于 构建 target 的 设置 。 处 理 链 从 右 到 左边 ， 由 右边 Xcode 针对 项 
目 类 型 的 默认 设置 开始 ， 经 过 project 和 target 级 别 ， 然 后 到 左边 的 net 设 置 。 你 可 以 编辑 project 或 者 target 等 级 中 的 设置 。 设 置 中 起 
作用 的 值 以 绿色 高 沈 显 示 


Ota Project 编 辑 器 中 有 一 个 相同 的 Build Settings 选 项 卡 ， 不 过 里 面 没 有 target-level 这 一 列 。 


每 一 级 中 设置 (不仅 来 自 于 继承 ) 的 值 都 用 绿色 背景 粗 体 显示 。 设 置 的 值 与 继承 的 值 之 间 的 区 别 非常 重要 : 比如 ， 你 在 
target 级 别 将 一 个 字符 串 设 置 为 空 ， 那 么 有 效 的 设置 将 是 这 个 空 字符 串 ， 而 不 是 继承 于 project 的 字符 串 。 如 果 你 更 改 了 project 
中 的 设置 ， 而 target 中 仍然 为 空 ， 那 么 起 作用 的 值 仍然 是 空 字符 串 一 一 请 参考 绿色 框 。 同 样 ， 将 右边 的 值 设置 为 与 左边 的 值 一 样 
也 不 能 况 明 接受 了 继承 的 值 ， 它 只 不 过 是 恰巧 和 继承 的 值 相同 而 已 。 


如 果 你 想 要 移 除 层级 中 的 覆 苹 设置 ， 那 么 选中 设置 中 的 那 一 行 ， 然 后 按 下 delete 按 键 。 这 个 设置 并 不 会 消失 ， 它 只 是 将 编辑 
器 操作 的 level (target 或 者 project) 中 的 该 设置 的 值 清除 而 已 。 当 你 看 到 当前 level 的 值 已 经 不 再 用 粗 体 显示 的 时 候 ， 你 束 会 看 
到 效果 ， 同 时 绿 框 也 会 进入 下 一 级 的 level 中 。 当 你 在 表 中 选择 了 另外 一 行 的 时 候 ， 不 市 值 的 单元 格 将 会 显示 为 空 日 。 


25.4 ”编辑 构建 变量 


Build Settings 表 知道 你 可 以 在 表 中 填充 哪些 值 。 


- Some values (一 些 值 ) 一 一 比如 可 以 放 在 Other C Flags 设 置 中 的 多 个 标记 ， 它 逻辑 上 是 一 个 列表 。Xcode 能 让 你 在 一 个 能 够 
添加 或 者 移 除 行 的 表 中 分 别 编辑 这 些 值 。 


- Some settings (一 些 设置 ) ， 比 如 Boolean (布尔 值 ) 或 者 code-signing identities (代码 签名 ) ， 会 被 限制 为 只 能 填写 少量 有 
意义 的 值 。Value 这 一 列 中 会 有 一 个 弹出 菜单 ， 里 面包 含 可 以 选择 的 值 。 


- 可 以 随意 编辑 的 任何 值 一 一 如 果 你 在 值 上 单 击 并 稍微 移动 下 鼠标， 那么 焦点 就 会 处 于 文本 框 中 。 





如果 你 正在 tatget 级 别 中 编辑 一 个 值 ， 并 想 要 补充 一 些 值 而 不 仅仅 是 替换 继承 值 ， 那 么 在 你 想 要 使 用 原始 设置 的 地 方 使 用 
$(inherited) 。 


Build Settings 表 会 根据 你 的 需求 过 滤 。Setting 列 描述 字符 串 的 下 面 是 Xcode 用 来 指定 构建 的 变量 名 称 。Value 这 一 列 显示 
的 是 有 效 值 (effectively) 而 不 是 实际 值 (actually) 。 当 你 编辑 依赖 其 他 变量 内 容 的 值 的 时 候 你 将 会 看 到 这 一 点: 
Architectures 设 置 在 列表 中 可 能 看 起 像 standard， 但 是 如 果 你 按照 文本 编辑 已 ， 你 会 友 现 它 实 际 上 是 $(ARCHS_ STANDARD)。 


PER 如 果 你 习惯 使 用 shell 脚 本 ， 你 习惯 用 花 括 号 分 隔 环境 变量 ， 例 如 : ${VISUALY。 括 号 中 的 字符 囊 会 被 所 包含 的 命 


令 对 应 的 值 替换 。 但 是 Xcode 中 的 构建 变量 不 是 这 样 ， 它 使 用 圆 括 号 指向 引用 的 值 ， 例 如 $SDKROOT)。 


你 可 以 更 改 表 显示 实际 的 变量 名 称 和 变量 值 。Editor 菜 单 中 的 Show Setting Names 命 令 将 会 显示 构建 变量 的 名 字 ; Show 


Definitions 将 会 显示 设置 的 原始 文本 。 


25.5 Ate 


到 现在 为 止 ， 我 将 构建 设置 视 为 默认 设置 和 重 写 设 置 的 产品 。 但 是 构建 设置 从 另外 一 个 角度 看 又 有 些 不 同 : 一 个 target 根 据 
构建 目的 不 同 可 能 有 多 个 不 同 的 设置 ， 比 如 debugging、release 或 者 distribution 版 本 。 你 可 以 将 这 些 设置 放 在 构建 配置 
(build configurations) 中 ， 这 样 就 可 以 在 产品 的 scheme 中 为 不 同 的 用 途 选 取 不 同 的 配置 。 


当 创建 一 个 新 项 目的 时 候 ，Xcode 会 为 你 提供 两 种 配置 : Debug 和 Release， 初 始 值 都 会 被 设置 成 与 构建 目的 一 致 的 合理 
值 。 通 常 ，Debug 配 置 会 生成 更 多 的 调试 信息 ， 并 关闭 了 代码 优化 ， 所 以 程序 会 在 调试 器 中 一 行 一 行 地 执行 。OS X 和 iOS 都 会 
在 多 处 理 器 架构 上 运行 App， 而 Debug 配 置 只 针对 一 种 染 构 编译 ， 所 以 会 节省 构建 时 间 。 


在 配置 间 切 换 很 简单 : Scheme editor 中 每 种 行为 的 Info 选 项 卡 都 包含 一 个 Build Configuration 弹 出 窗口 ， 它 能 让 你 根据 
行为 选择 配置 文件 。 仪 需 一 步 操 作 就 能 完成 切换 操作 ， 当 执行 指定 行为 的 时 候 ， 按 下 option 键 就 能 在 不 同 的 配置 间 切 换 。 将 会 
出 现 Scheme 编 辑 器 界面 ， 在 处 理 之 前 ， 你 可 以 做 出 更 改 。 


如 果 你 的 target 依 赖 于 其 他 targets， 甚 至 是 其 他 项 目 中 的 target， 只 要 这 些 target 有 相同 名 字 的 配置 文件 ， 那 么 这 些 target 
就 会 使 用 你 在 构建 时 指定 的 配置 ， 否 则 它们 就 会 使 用 默认 的 配置 文件 构建 . 


调整 配置 


构建 配置 的 目的 在 与 能 够 根据 不 同 的 目的 更 改 设置 ， 也 可 以 进行 条 件 设置 。 在 你 浏览 Build Setting 选 项 卡 中 的 选项 时 ， 你 
可 能 会 注意 到 部 分 设置 旁边 有 个 提示 三 角 (图 25.5) ， 它 们 的 值 是 灰色 的 “<Multiple values>” 。 根 据 使 用 的 配置 不 同 ， 这 些 
设置 会 有 不 同 的 值 。 单 击 提示 三 角 ， 这 一 行 就 会 展开 ， 显 示 包 含 可 用 配置 的 子 行 。 你 可 以 在 这 里 做 出 选择 。 
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A255 “” 当 一 个 设置 对 于 不 同 的 配置 有 不 同 的 值 时 ， 它 的 值 会 显示 为 “<Multiplevalues>” ，Xcode 在 这 一 行 的 旁边 会 显示 一 个 提 
示 三 角 。 单 击 提 示 三 角 就 会 显示 配置 和 它们 对 应 的 值 


如 果 将 鼠标 放 在 所 有 配置 都 使 用 相同 设置 的 某 一 行 上 面 ， 融 会 出 现 一 个 临时 的 提示 三 角 。 再 次 打开 这 一 行 融会 显示 每 个 配置 
赋 给 这 个 设置 的 值 (如果 不 更 改 ， 那 么 对 应 的 值 将 完全 相同 ) 。 


图 25.6 将 它们 联系 在 一 起 : 它 显示 了 设置 如 何 从 软 认 值 变 为 project 和 target 设 置 ， 最 后 到 达 管 理 和 决定 构建 过 程 的 值 。 如 
果 需 要 ， 你 可 以 添加 目 己 的 配置 文件 。Project 编 辑 器 内 Info 选 项 卡 中 包含 项 目 所 有 可 用 的 配置 。 你 可 以 将 Debug 和 Release 配 置 
作为 基础 ， 创 建 自 定义 配置 。 想 要 创建 新 的 配置 ， 需 要 单 击 + 按 钮 ， 它 会 弹出 一 个 菜单 ， 里 面 提供 复制 一 个 已 经 存在 的 配置 的 选 
项 一 一 无 法 创建 一 个 空 配 置 ， 因 为 新 的 配置 必须 包 合 某 些 设置 。 选 择 一 个 想 要 作为 基础 的 配置 ， 输 入 名 字 ， 这 样 束 创建 了 一 个 
新 配置 。 
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图 25.6 ”继承 构建 设置 的 完整 示例 。 默 认 情 况 下 ，Xcode 为 了 减 小 产品 的 尺寸 ， 会 将 所 有 的 编译 选项 都 设置 为 优化 〈 下 ) ; 
些 设置 会 保存 到 Release 构 建 中 ,但 是 对 于 Debug 配 置 ，target 会 关闭 所 有 的 优化 设置 。Project 会 将 base SDK 都 设置 为 iPhoneOS ， 
这 就 意味 着 不 管 当 前 的 iDS SDK 是 什么 版 本 ， 都 会 使 用 iPhoneOS 这 个 配置 (中 ) 。 根 据 配 置 ， 开 发 者 为 不 同 的 值 定义 了 一 个 
DEBUG_LEVEL 宏 (上) 。 结 果 就 是 一 系列 构建 设置 都 会 分 为 debugging (LA) 和 telease (LF) 


25.6 配置 文件 


配置 文件 也 有 一 个 提示 三 角 。 打 开 一 个 配置 ， 你 将 会 看 到 项 目 包含 的 targets 列 表 。 它 能 让 你 选择 一 个 配置 文件 ， 并 为 每 个 


target 调 整 配置 。 


什么 是 配置 文件 ”下 面 是 基本 的 前 述 : 你 有 多 个 项 目 ， 可 能 你 有 一 些 设置 规范 并 且 要 应 用 到 所 有 设置 ， 而 Xcode 提供 的 默认 
值 不 适合 你 。 如 果 你 仅仅 使 用 Project/Target 编 辑 器 ， 那 么 需要 手动 为 每 个 项 目 设 置 这 些 配 置 。 如 果 因 为 target 类 型 不 同 ， 需 求 
也 多 种 多 样 ， 你 将 不 卉 重负 。 


配置 文件 (.xcconfig) 束 是 这 个 问题 的 解决 方案 。 其 中 有 一 些 包 合 设置 的 文本 文件 ， 这 些 键 值 对 就 是 你 想 要 使 用 的 任意 设 
置 。 


25.6.1 创建 配置 文件 


选择 File 一 New 一 Filehttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (ÆN) ， 在 New File 帮 助 界 面 的 Other 目录 
(OS X 或 者 jiOS 都 没有 关系 ) 下 找到 Configuration Setting File， 就 能 创建 一 个 xcconfig 文 件 。 然 后 就 是 一 些 常规 操作 : 为 
xcconfig 文 件 命名 ， 选 择 存放 目录 并 将 它 指 同 一 个 项 目 ， 它 也 会 提供 让 这 个 文件 成 为 某 个 target 一 部 分 的 选项 。 你 并 不 想 让 配置 
文件 复制 到 产品 中 ， 所 以 确保 没有 选中 任何 target。 


SER xcconfig 文 件 必须 包含 在 项 目 中 而 不 是 包含 在 target 中 ， 在 创建 新 项 目 之 前 就 能 找到 并 使 用 配置 文件 。 


当 你 完成 这 一 切 的 时 候 ， 你 会 友 现 已 经 得 到 了 一 个 空 的 文本 文件 ， 不 过 文件 的 顶部 包含 一 个 注释 块 ， 注 释 里 面 有 你 的 名 字 .、 
版 权 和 创建 日 期 。 现 在 做 什么 呢 ? 在 命令 行 中 可 以 进一步 了 解 这 个 过 程 : 如 果 你 为 xcodebuild 命 令 提供 了 target、 架 构 和 感 兴 
趣 的 配置 文件 ， 再 加 上 -showBuildsetting 选 项 ， 它 残 能 打印 构建 过 程 中 用 到 的 所 有 的 环境 变量 。 

$ xcodebuild -showBuildSettings -configuration Release 
Build settings for action build and target "Mac Passer Rating": 
ACTION = build 
ALTERNATE GROUP = staff 
ALTERNATE MODE = u+w,go-w,a+rX 
ALTERNATE OWNER = fritza 


ALWAYS_SEARCH_USER_PATHS = NO 
ALWAYS_USE_SEPARATE HEADERMAPS = YES 


APPLE INTERNAL DEVELOPER_DIR = /AppleInternal/Developer 
APPLE _ INTERNAL DIR = /AppleInternal 


但 是 有 一 个 问题 : 并 不 是 每 个 构建 设置 都 会 贯穿 整个 构建 过 程 。 比 如 ， 当 Xcode 构 建 clang 构 建 命令 的 时 候 ，Xcode 需 要 使 
用 GCC_ENABLE_ CPP_RTTI， 这 个 符号 从 来 都 没有 在 列表 中 出 现 过 ， 但 它 是 一 个 开始 。 记 住 你 不 需要 将 每 个 设置 都 放 在 一 个 配 
置 文件 中 ， 虽 然 配 置 文件 对 此 没有 限制 ， 如 果 想 根据 SDK 或 者 架构 设置 提供 不 同 的 设置 ， 那 么 需要 让 xcodebuild 分 别 生 成 不 同 
的 设置 列表 ， 并 像 下 面 介绍 的 那样 合并 在 一 起 。 


一 旦 完成 ， 你 可 以 回 到 Project 编 辑 器 的 Info 选 项 卡 ， 然 后 使 用 Based on Configuration File 列 中 的 弹出 窗口 选择 xcconfig 


文件 。 


25.6.2 ”SDK 和 指定 的 架构 设置 


Cocoa 开 友 经 党 会 针对 不 同 的 SDK 和 处 理 器 架构 生成 不 同 的 二 进 制 文件 。 针 对 ARMv7 编 译 的 iOS App 无 法 运行 企 ARMv6 的 
设备 或 者 模拟 器 上 。 你 可 能 想 要 在 OS X 10.6 SDK 上 使 用 32 位 机 器 上 构建 ， 但 是 在 10.7 上 使 用 64 位 的 机 器 构建 。Xcconfig 格 式 
允许 这 种 情况 出 现 。 比 如 ， 文 件 中 可 能 包 合 : 


(1) GCC VERSION = com.apple.compilers.llvm.clang.1_0 

(2) GCC_VERSION [sdk=iphonesimulator4.3] [arch=*] = 
com.apple.compilers.llvmgcc42 

(3) GCC_VERSION [sdk=iphoneos4.3] [arch=armv6] = 4.2 


1) 任何 构建 都 使 用 clang， 除 非 根据 潜 举 条 件 将 其 履 兰 。 


2) 如 果 构 建 中 使 用 了 iOS Simulator 4.3 SDK， 那 么 使 用 gcc-fronted llvm 编 译 器 (因为 空间 原因 我 将 它 分 为 了 两 行 ， 实 际 
上 它们 应 该 在 一 行 中 ) 。 


3) 如 果 针 对 iOS4.3 操 作 系 统 和 ARMv6 染 构 进 行 构建 ， 那 么 使 用 gcc4.2 (这 个 疯狂 的 配置 仪 仪 作为 例子 使 用 ，Xcode 甚 至 都 
不 使 用 gcc 或 者 Ilvmgcc， 并 且 用 gcc 生 成 ARM 代 码 会 很 糟糕 ) 。 


使 用 glob 表 达 式 匹配 对 应 的 SDK 和 架构 ， 这 就 意味 着 如 果 你 需要 表达 一 定 范 围 的 匹配 ， 比 如 “any iOS 8”， 那 么 将 会 匹配 
到 iphoneos8*， 就 像 对 其 他 OS 无 条 件 的 设置 一 样 。 


SER 图 形 编辑 器 也 允许 你 设置 条 件 。 当 你 把 鼠标 放 在 配置 中 的 一 个 设置 上 的 时 候 ， 就 会 显示 一 个 小 小 的 + 按钮 ， 单 击 
这 个 按钮 就 会 在 配置 中 添加 一 个 条 件 行 。 这 一 行 的 标题 是 一 个 下 拉 菜 单 ， 你 可 以 在 这 个 菜单 中 选择 可 用 的 条 件 ， 见 图 25.7。 因 为 


Xcode 在 配置 中 设置 了 条 件 变量 ， 所 以 你 可 以 为 每 个 配置 复制 这 个 条 件 。 


T nstrumen Program Flow 
Dabug 


He lass 





i Pa 


kam ~ Ary Anahi 


Link arm 
iak si 
or mM d & 
No L 
Op y Any SDK 
I 
| i 
i Arme fs A 
Opti l ki; kT 
oS K 10.10 
Pela OS X 10.5 
inil 
F Santi 
i Ary IOS Simulatgr 
| Rm Gimulator f.z 
Un 
Like Ary IOS 
DS 8.2 
国 = fT GT i-a = F i 





Ne s 


Ma 避 


Yes = 
Ao i 
E jli io Foose» 
Hona [= 志和 | %. 
Pasiesl, Smallest | 
‘Users/fitzaGropk 
Hoo 
You = 

MUU BIE alunsa - 
HB i 
Tig i 
Ho $ 


MiG = 


图 25.7 ”构建 设置 中 的 每 个 配置 标签 穷 边 都 有 一 个 + 按钮 ， 能 让 你 选择 架构 、OS 和 新 条 件 设置 将 会 应 用 的 平台 的 组 合 


25.6.3” 预 处 理 xcconfig 文 件 


与 C 家 族 源 代码 一 样 ， 你 可 以 在 一 个 xcconfig 文 件 中 使 用 #include 指 令 插 入 另外 一 个 xcconfig 文 件 中 的 内 容 。 借 助 这 种 方 


法 ， 你 束 能 拥有 一 个 基本 的 配置 文件 ， 其 中 包含 对 所 有 target 和 和 构建 配置 都 通用 的 设置 ， 使 用 #include 命 令 将 它们 引入 后 ， 表 根 


据 需 要 针对 菏 个 文件 特别 配置 。 


这 个 功能 有 一 个 很 有 意思 的 小 技巧 。 考 虑 下 面 的 配置 文件 ( 称 为 Common.xcconfig) : 


MY _LIBS_FOR_DEBUG = -lmystuff_debug 
MY_LIBS_FOR_RELEASE = -lmystuff 
OTHER_LDFLAGS = $(MY_LIBS FOR $ (WHICH LIB)) 


可 能 还 有 一 个 Debugging.xcconfig 文 件 设 置 为 下 面 这 样 : 


WHICH_LIB = DEBUG 
#include "common.xcconfig" 


另外 有 一 个 Release.xcconfig 文 件 的 设置 为 这 样 : 


WHICH _ LIB = RELEASE 
#include "common.xcconfig" 


这 样 做 的 效果 就 是 : Debug.xcconfig 中 将 OTHER LDFLAGS 设 置 为 -IMY LIBS FOR DEBUG, Release.xcconfig Pi¥ 
OTHER_LDFLAGS 设 置 为 -IMY_LIBS_FOR_RELEASE。 在 这 个 向 单 的 例子 中 ， 如 果 仅 仪 在 各 目的 文件 中 设置 OTHER_LDFLAGS 的 
值 会 更 简单 ， 但 是 通过 这 种 方法 能 更 精确 地 控制 条 件 配置 。 


xcconfig 文 件 没有 头 文件 搜索 目录 。 如 果 你 #include 一 个 文件 ， 那 么 被 引用 的 文件 要 与 使 用 它 的 文件 在 同一 个 目录 下 。 


25.7 ”人 敬 令 行 工具 


有 的 时 候 ， 命 令 行 工 具 无 可 蔡 代 。UNIX 命 令 行 有 一 个 非常 易 懂 的 接口 用 于 脚本 编写 和 控制 复杂 的 工具 。Apple 为 Xcode 构 
建 系统 和 工具 集 提 供 了 一 个 命令 行 接 口 ， 其 中 主要 包括 3 个 命令 : xcodebuild、xcrun 和 xcode-select。 


25.7.1 xcodebuild 


xcodebuild 的 使 用 方法 非常 简单 : 将 工作 目录 设置 到 包含 .xcodeproj 项 目 包 所 在 的 目录 ， 然 后 调用 xcodebuild， 指 定 
project、target、 配 置 ， 以 及 任何 想 要 指定 的 设置 。 如 果 这 个 目录 仅 有 一 个 .xcodeproj 包 文件 ， 那 么 所 有 的 这 些 选 项 都 可 以 使 
用 默认 值 ， 可 以 简单 地 输入 : 


$ xcodebuild 


这 条 命令 将 会 构建 工作 目录 下 .xcodeproj 包 文件 中 当前 配置 的 第 一 个 target。Apple 提 供 这 条 命令 的 目的 是 因为 xcodebuild 
可 以 用 来 完成 日 党 构建 或 者 常规 友 布 脚本 ， 残 像 make 所 提供 的 功能 。 


在 构建 一 个 target 的 过 程 中 ， 为 xcodebuild 指 定 7 种 行为 中 的 一 个 。 


‘build: 默认 行为 ， 构 建 指定 的 target， 使 用 SRCROOT 中 的 文件 生成 产品 ， 将 生成 的 产品 放 到 SYTMROOT 中 。 它 与 Xcode 应 
用 程序 中 的 Build (用 于 调试 ) 命令 的 功能 一 样 。 


‘test: 运行 所 选 的 scheme 对 应 的 测试 用 例 。 你 可 以 选择 测试 用 例 运行 的 目标 : 与 计算 机 相连 接 的 设备 或 者 一 个 模拟 器 。 
- analyze: 与 Product 一 Analyze 这 个 命令 的 效果 一 样 。 你 可 以 指定 一 个 target， 而 且 必 须要 指定 一 个 scheme。 

- archive: 与 Xcode 中 Product 一 Archive 这 个 命令 的 效果 一 样 。 你 必须 指定 用 于 构建 的 工作 空间 和 scheme。 

- clean: 移 除 SYMROOT 中 的 产品 和 所 有 中 间 文 件 。 它 与 Xcode 应 用 程序 中 的 Clean 命 令 的 效果 一 致 。 


install: 构建 指定 的 tareet 并 将 它 安装 到 INSTALIL DIR (通常 是 DSTROOT) 目录 下 ， 会 设置 Installation Preptocessing 构 建 变 


量 。Xcode 中 没有 直接 与 之 相对 应 的 行为 ， 因 为 没有 办 法 提升 Xcode 的 权限 ， 让 它 能 够 设置 所 有 权 、 许 可 ， 还 有 目标 目录 。 


-installsrc: 将 项 目 目 录 复 制 到 SRCROOT 中 。 在 Xcode 的 前 身 Project Buildetr 中 ， 这 个 行为 的 范围 仅 局 限于 项 目 文 件 包 和 其 中 
列 出 的 源 文 件 ， 但 是 现在 看 起 来 ， 它 的 功能 与 Finder 中 的 复制 命令 或 者 命令 行 中 的 cp 命令 相差 无 几 。 


WER ”运行 xcodebuild 时 可 以 添加 诸如 SRCROOT 这 样 的 设置 ， 添 加 方式 是 在 参数 中 包含 一 些 赋值 的 键 值 对 


(SETTING=value) 。 


如 果 当 前 目录 下 有 多 个 项 目 或 者 工作 空间 包 ， 你 必须 通过 -project 或 者 -workspace 选 项 指定 感 兴 趣 的 项 目 或 者 工作 空间 ， 
这 两 个 选项 后 面 要 跟着 所 选 包 的 名 称 。 若 没有 指定 target， 那 么 默认 情况 下 选择 的 束 是 第 一 个 target， 也 可 以 指定 -alltargets。 


如 果 命 令 行 中 没有 传 入 -configuration 标 记 ， 那 么 xcodebuild 会 使 用 在 Scheme 编辑 器 面板 中 指定 的 配置 来 控制 构建 行为 。 
对 于 需要 scheme 的 命令 ， 你 必须 使 用 -scheme 选 项 为 其 指定 一 个 scheme， 无 论 如 何 设置 一 个 scheme 都 是 很 好 的 做 法 。 


与 项 目 窗口 中 工具 栏 的 scheme selector 一 样 ， 你 可 能 需要 指定 一 个 -destination， 比 如 模拟 器 配置 、 操 作 系 统 、 连 接 的 设 
备 、CPU 架 构 或 者 平台 ， 所 有 这 些 设置 都 需要 使 用 键 值 对 的 形式 来 设置 。 在 命令 行 中 输入 man xcodebuild 可 以 查看 详细 内 容 。 


使 用 man xcodebuild 能 够 查看 完整 的 细节 。 
25.7.2 xcode-select 


在 计算 机 上 装 有 多 个 版 本 的 Xcode 很 正常 。 每 年 的 6 月 ，WWDC 之 后 最 容易 出 现 这 种 情况 : Apple 在 WWDC 上 会 发 布 新 版 
操作 系统 ， 与 此 同时 还 会 为 开发 者 提供 预 哆 版 的 Xcode 以 及 非 最 终 版 本 的 新 系统 SDK。 在 这 期 间 ， 开 上 友 者 仍然 需要 开发 和 维护 针 
对 当前 OS 版 本 的 App， 所 以 他 们 需要 同时 安 六 当前 稳定 版 本 的 Xcode 和 预 哆 版 的 Xcode。 


Ot 如 果 你 需要 在 计算 机 上 保留 多 个 Xcode 版 本 ， 那 么 不 要 在 Mac 应 用 商店 中 更 新 Xcode ， 它 会 移 除 之 前 所 有 版 本 的 


Xcode。 详 情 见 1.5 节 。 


每 个 版 本 的 Xcode 都 有 它 自 己 的 工具 集 和 这 个 版 本 对 应 的 SDK， 这 是 我 们 感 兴趣 的 两 部 分 内 容 。 如 果 在 命令 行 中 调用 
xcodebuild, 或 者 像 clang 这 样 的 工具 ， 怎 样 才能 知道 你 正在 使 用 的 工具 束 是 你 想 要 使 用 的 那个 版 本 的 工具 ? 对 于 命令 行 工 具 来 
说 ， 仅 仅 相 信 /usrYbin: 中 的 版 本 信息 并 不 可 靠 : 这 个 目录 下 的 工具 并 不 是 工具 本 身 。 如 果 你 查看 这 些 工 具 ， 你 会 友 现 无 论 这 些 
工具 多 人 么 复杂 ， 它 们 忆 是 14KB 大 小 。 这 是 因为 它们 是 跳板 应 用 (trampoline app) ， 它 们 会 指向 Xcode bundle (如 果 命 令 行 
工具 不 是 用 Xcode 下 载 的 ， 那 么 它们 会 指向 下 载 目录 ) 中 真正 的 App。 所 以 你 需要 让 这 些 跳板 应 用 指向 你 想 要 的 程序 。 


你 可 以 使 用 xcode-select 完 成 这 个 操作 ， 箔 日 来 说 如 下 : 
$ sudo xcode-select --print-path 


这 条 命令 会 告诉 你 当前 使 用 的 Xcode 版 本 ， 然 后 输入 : 


$ sudo xcode-select --switch /Applications/Xcode-6.2.app 


就 会 指定 当前 使 用 的 版 本 (在 这 个 例子 中 是 46.2) 。xcode-select 会 在 Xcode 包 中 记录 Developer 目 录 ， 但 是 你 也 能 通过 指 
定 带 有 .app 后 绥 的 完整 路 径 的 方式 来 选择 使 用 哪个 Xcode。 


9 注意 ” 当 你 下 载 Xcode beta 版 的 时 候 ， 你 会 发 现 Apple 已 经 将 它 命名 为 Xcode-beta， 没 有 带 版 本 信息 。 我 更 喜欢 使 用 版 本 号 
将 它们 重 命名 ， 就 像 这 里 显示 的 那样 。 


Xcode-select 所 做 的 更 改 会 影响 机 器 上 所 有 的 用 户 和 系统 资源 ， 所 以 你 必须 提供 管理 员 权 限 ， 比 如 通过 sudo 才 能 做 出 更 改 。 
25.7.3 xcrun 


如 果 你 有 多 个 项 目 ， 需 要 不 同 SDK 和 工具 集 ， 那 么 会 遇 到 一 些 问题 ， 这 些 问 题 并 非 源 于 Xcode 本 身 一 一 1DE 忌 是 会 找到 它 自 
已 的 版 本 一 一 而 是 源 于 脚本 和 makefile 文 件 。 根 据 管理 员 的 心情 使 用 相同 的 makefile 文 件 生成 不 同 产 品 的 做 法 不 靠 说 。 


Xxcrun 会 强制 你 选择 一 个 SDK 和 一 个 工具 集 。 比 如 ， 如 果 你 需要 找到 clang， 那 么 你 可 以 运行 : 


$ # Find the currently-selected version of the Swift compiler: 
$ xcrun --find swiftc 
/Applications/Xcode-Beta.app/Contents/.../usr/bin/swiftc 

$ # What SDKs are installed? 

$ xcodebuild -showsdks 


OS X SDKs: 

OS xX 10.9 -sdk macosx10.9 
OS X 10.10 -sdk macosx10.10 
iOS SDKs: 

103 8.2 -sdk iphoneos8.2 


iOS Simulator SDKs: 


Simulator - iOS 8.2 -sdk iphonesimulators.2 
$ # Run the Swift compiler for the 10.10 SDK: 
$ xcrun --sdk macosx10.10 swiftc -print-ast SimpleCSVFile.swift 


25.8” 目 定义 构建 规则 


Xcode 的 构建 系统 能 扩展 到 新 文件 类 型 和 处 理工 具 。 构 建 系统 中 默认 的 规则 会 将 文件 扩展 名 与 产品 类 型 相 匹配 ， 并 处 理 任 何 
比 产 品 新 的 源 文件 。 你 可 以 添加 一 个 上 自 定义 规则 ， 让 构建 系统 查找 与 模式 相 匹 配 的 文件 名 ， 然 后 在 这 些 文件 上 执行 一 个 命令 ， 见 
图 25.8 上 。 
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图 25.8 (LE) Target 编 辑 器 中 的 Build Rules 选 项 卡 会 让 你 根据 工具 匹配 文件 类 型 ， 并 用 这 些 工 具 处 理 这 些 文件 。 当 你 第 一 次 检查 
文件 列表 的 时 候 ， 它 会 为 标准 的 文件 类 型 指定 默认 的 行为 。 (下 ) 选择 Editor>Add Build Rule 可 以 在 表 中 添加 一 行 ， 在 这 一 行 中 


可 以 指定 一 个 文件 类 型 和 处 理 这 个 文件 类 型 的 规则 (可 能 是 你 上 自己 的 脚本 ) 


Ose 另外 一 种 扩展 构建 系统 的 方法 是 添加 一 个 Run Script build phase. 9.4.37 Pw TA WE. Run Sctipt 阶 段 为 构建 
行为 提供 了 更 大 的 自由 度 ,， 但 是 它们 牺牲 了 构建 规则 对 指定 文件 类 型 的 每 个 文件 的 适用 性 。 


当 Build Rules 选 项 卡 可 见 的 时 候 ， 选 择 Editor 一 Add Build Rule 创 建 一 条 新 规则 ， 或 者 单 击 视图 顶部 的 + 按钮 也 可 以 创建 一 
条 新 规则 。 表 的 项 部 会 出 现 一 个 新 行 ， 其 中 包含 用 于 新 规则 的 编辑 器 。Process 弹 出 菜单 允许 你 从 Xcode 已 知 的 源 代 人 码 文 件 类 型 
中 选择 类 型 ， 而 且 它 还 包含 一 个 Source files with names matching 选 项 : 它 能 使 用 glob 表 达 式 (比如 *.lemon) 指定 源 代码 文 


件 。 


Using 弹 出 窗口 中 显示 了 Xcode 所 有 标准 的 编译 器 ， 或 者 你 也 可 以 选择 Custom script: 为 你 自己 的 脚本 打开 一 个 编辑 器 ， 
见 图 25.8 下 。 不 用 担心 文本 栏 的 大 小 ， 它 会 随 着 你 的 输入 逐渐 扩展 。 


在 shell 命 令 中 你 可 以 使 用 任何 喜欢 的 构建 变量 。 除 此 之 外 ， 还 有 一 些 专 | ] 用 于 目 定 义 规则 调用 的 变量 : 

- INPUT_FILE_PATH， 源 代码 的 完整 路 径 (/Users/xcodeuser/MyProject/grammar.lemon) o 

. INPUT_FILE_DIR， 包 含 源 代码 文件 的 目录 (/Users/xcodeuser/MyProject/) o 

.INPUT_FILE NAME ， 源 代码 文件 名 (grammar.lemon) 。 

- INPUT_FILE_BASE， 不 带 有 后 级 的 源 代 码 文 件 的 基本 名 称 (grammar) 。 

Apple 建 议 将 中 间 文 件 ， 比 如 解析 生成 器 处 理 源 代码 文件 的 输出 放 到 变量 DERIVED_FILE_DIR 所 指 的 目录 。 


9 注意 ”在 这 个 例子 中 ， 在 项 目 中 添加 一 个 .Jlemon 文 件 并 不 会 达到 你 的 目的 。 构 建 规则 会 将 这 个 文件 视 为 源 代码 文件 ， 但 
是 Xcode 不 会 。 简 单 地 添加 这 个 文件 会 将 它 放 到 Copy Bundle Resoutces 构 建 阶段 中 。 所 以 你 不 得 不 将 这 个 文件 从 Copy Bundle 


Resoutces 构 建 阶段 移动 到 Compile Sources phase。 然 后 ， 借 助 继承 源 文件 目录 中 的 产品 文件 ， 这 个 产品 文件 就 会 自动 编译 。 


你 无 法 删除 或 者 编辑 规则 列表 中 的 默认 设置 ， 但 是 你 添加 的 任何 规则 都 会 履 兰 列表 下 面 出 现 的 对 应 规则 。 将 你 的 规则 同上 或 
者 辐 下 拖 动 葡 能 设置 它们 的 优先 级 。 你 无 法 将 一 个 规则 拖 动 到 标准 规则 之 下 ， 但 是 没有 关系 : 为 什么 不 添加 一 个 目 定 义 规 则 ， 然 
后 指定 需要 履 关 的 标准 规则 呢 ? 


25.9 REHE 
选择 一 个 行为 或 者 执行 Build 命 令 ， 或 者 执行 Product 菜 单 中 与 Build 命 令 相 关 的 命令 束 能 让 构建 系统 开始 运行 (Build 只 是 
Product 一 Build For 一 Build For Running, 了 eR 的 别名 ) 。 


w tE ”一旦 你 已 经 记 住 了 这 些 行为 的 快捷 键 ， 比 如 Run、'Test/Profile 和 Analyze， 那 么 就 能 按 下 shift 键 ， 在 没有 完成 上 个 行 


为 的 情况 下 就 直接 开始 执行 对 应 的 构建 操作 。 


如 果 一 切 正常 ， 得 到 的 结果 丈 是 嵌入 产品 中 的 一 个 文件 或 者 包 。 如 果 不 成 功 ， 那 么 熟悉 的 lssue 导 般 器 中 丈 会 列 出 所 有 的 错 
误 、 和 警告 及 相关 信息 ， 选 择 一 个 问题 残 能 跳 转 到 3 引 友 这 个 问题 的 源 代码 。 





但 是 有 时 候 这 还 不 够 ， 你 可 能 想 要 了 解构 建 过 程 及 正确 与 否 一 一 也 许 你 会 怀疑 某 个 步骤 没有 执行 。 同 时 ， 如 果 在 链接 或 者 
代码 签名 阶段 遇 到 了 一 个 错误 ， 那 么 Issues 导 航 器 中 显示 的 信息 就 没有 太 大 帮助 ， 因 为 它们 没有 对 应 的 源 代 码 。 所 以 ， 这 个 时 候 
Report 导 航 器 就 派 上 用 场 了 。 


Report 导 舰 器 (Navigator 区 域 中 第 八 个 选项 卡 ) 中 有 一 项 包含 了 产品 生成 阶段 每 一 个 主要 的 事件 ， 比 如 行为 或 者 源 代码 控 
制 命令 一 一 任何 能 从 处 理事 件 的 工具 中 生成 文本 记录 的 命令 。 


执行 一 次 构建 操作 ， 选 择 Report 导 舰 器 ， 然 后 单 击 顶部 代表 你 最 后 一 次 操作 的 结果 的 那 一 项 ， 你 将 会 看 到 这 个 行为 所 需要 
的 步骤 概述 ， 见 图 25.9。 


HH < > | Analyze Passer Rating : 6:35:27 PM 


Al) Mee = Allissues Errors Only 


= Ay nran target mee Rating p o — 
| | Project Passer Rating | Configuration Debug | Destination iPhone 6 | SOK Simulator - iOS 8.2 
© Create product structure 
¥ Ọ Compile Swift source files g4 
© Compile AppDelegate swift .in /Users/fritza/DropboxwBook/NEStl/submission-packs/2014-11-17-X6StF/Source Code Ch... 
@ Compile Game.swift ...in /Users/fritza’/Dropbcx/Book/X6StF/submission-packs/201 4-11-17-M6StF/Source Code/Chapter 1... 
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@ Compile Extensions.swift ...in /Users/fritza/Dropbox/Book/X6StF/submission-packs/2014-11-17-X8StF/Source Code/Cha... 
Ọ Compile Passer.swilt ...in /Users/ritza’ Dropbox Book/M6StF/submission-packs/2014-11-17-GStF/Source Code/Chapter... 
@ Compile VUtilities.swift ,ln /Users/fritza/Dropbox/Book/X6S1F/submission-packs/2014-11-17-X6SI(F/Source Code/Ghapter... 
© Compile _Game.switt ...in /Users/tritza/Dropbox/Book/A6StF/SuDbMmission-packs/2014-11-17-xX6StF/Source Code/GCnapter... 
¥ @ Compile GameListControler.swift ...in /Userstritza/Dropbox/BooWX6St1F/Submission-packs/2014-11-17-x6Str/... 4 

© Game’ does not have a member named 'passerRating' 

© ‘Game’ does not have a member named 'passerRating' 

© ‘Game' does not have a member named 'passerRating' 

@ Game’ does not have a member named 'passerRating' 


Build failed 17/22/14, &35 PM 
4 errors 





Analyze Passer Rating : 8:35:27 PM 
































All All Massages All Issues | Errors Only 


yh Analyze target Passer Rating 
V i Project Passer Rating | Configuration Debug | Destination iPhone 6 | SDK Simulator - iOS 8.2 
¥ Ọ Compile Swift source files a4 
¥ © Compile GameListController.swift ...in /Usersyfritza/Dropbox/Book/X6StF/submission-packs/2014-11-17-X6StF/... @p4 
@ ‘'Game' does not have a member named 'passerRating' 
© 'Game' does not have a member named ‘paseerRating' 
© 'Game' does not have a member named 'passerAating' 
© ‘Game’ does not have a member named ‘passerRating' 
Build failed 11/22/14, &35 PM 


4 errors 





图 25.9 ”构建 的 日 志 能 通过 过 滤 操 作 将 显示 范围 缩小 到 你 感 兴趣 的 内 容 。 如 果 选 择 All Messages (不 显示 ) ， 你 将 会 得 到 构建 过 程 


中 每 个 行为 的 列表 ， 其 中 包括 那些 成 功 的 步 又。 如果 你 单 击 Etrtots Only， 那 么 列表 中 将 只 显示 错误 信息 


选项 卡 下 面 的 按钮 提供 了 AlVRecent 和 All Messages/All Issues/Errors Only 这 几 种 选择 。 后 面 的 组 按照 重要 性 进行 过 渡 : 
all-message 设 置 列 出 了 发 生 的 所 有 事情 ， 无 论 好 坏 。 剩 下 的 设置 排除 了 成 功 步骤 的 条 目 和 那些 可 能 阻止 构建 完成 的 步骤 。 


All 设 置 显 示 了 对 target 当 前 状态 有 意义 的 每 一 个 步骤 。 它 与 你 最 后 执行 构建 操作 时 生成 的 事件 列表 不 同 : 最 后 一 次 构建 没 
有 重复 编译 那些 未 做 修改 的 源 代 码 ， 那 些 文件 来 目 于 更 早 乙 前 的 构建 。All 设 置 将 之 前 的 编译 信息 融入 当前 target 完 整 的 编译 信 
息 中 。 如 果 你 只 想 查 看 上 次 构建 时 的 内 容 ， 那 么 选择 Recent。 





25.10 ”简单 的 构建 记录 


下 面 是 打包 Passer Rating 的 构建 脚本 ， 它 是 由 14 个 Swift 文 件 和 少量 的 资源 构建 而 成 的 简单 App。 


我 通过 Archive 构 建 运 行 这 个 项 目 ， 它 会 处 理 App 中 的 每 个 元 素 ， 包 括 armv7 和 armv7s 架 构 。 当 构建 完成 的 时 候 ， 我 在 
Report 导 航 器 中 选中 它 ， 然 后 选择 All 历 史 和 All Messages， 然 后 选择 Editor 一 Copy Transcript for Shown Results (All, All 
Messages) as Text， 最 后 将 结果 复制 到 文本 编辑 器 中 。 


构建 记录 的 文本 有 590 行 ，96KB。 构 建 过 程 中 使 用 的 命令 若 放 在 一 行 中 将 会 超过 6000 个 字 待 ， 调 用 的 系统 路 径 有 270 个 左 
右 。 下 面 是 构建 过 程 的 简化 版 本 ， 它 更 像 一 个 schematic (示意 图 ) 。 


大 部 分 构建 工具 都 在 Xcode 应 用 程序 包 本 身 的 深层 目录 中 。 中 间 的 路 径 简化 为 Xcode.app。 


` 中 间 产 物 和 最 后 的 产物 都 在 复杂 的 树 目录 中 : ~/Library/Developer/Xcode/DerivedData。 这 些 目 录 都 被 简化 为 
~/Library/Developer/Xcode， 直 到 路 径 的 最 后 两 部 分 元 素 。 


- 构建 文本 的 ~/TargetDirectory 目 录 作 为 一 个 从 /Users 到 项 目 文件 夹 中 的 目标 路 径 的 完整 路 径 名 。 
: 我 用 反 斜 杠 将 命令 分 成 多 行 。 对 于 分 成 上 下 两 行 的 命令 或 者 被 其 他 命令 包含 的 命令 ， 我 对 第 二 行 采 取 了 缩 进 的 显示 方式 。 
如 果 你 想 要 完整 的 经 验 ， 那 么 融 按 照 我 说 的 做 ， 然 后 查看 最 后 的 结果 。 下 面 是 经 过 编辑 的 构建 记录 。 
Build target Passer Rating 


Write auxiliary files 


/bin/mkdir -p ~/Library/Developer/.../Passer\ Rating. build 

write-file ~/Library/Developer/.../Passer\ Rating.hmap 

write-file ~/Library/Developer/.../Passer\ Rating-generated-files.hmap 
/bin/mkdir -p ~/Library/Developer/.../arm64 

write-file ~/Library/Developer/.../arm64/Passer\ Rating.LinkFileList 
write-file ~/Library/Developer/.../swift-overrides.hmap 

/bin/mkdir -p ~/Library/Developer/.../armv7 

write-file ~/Library/Developer/.../armv7/Passer\ Rating.LinkFileList 
write-file~/Library/Developer/.../Passer\ Rating-project-headers.hmap 


Create product structure 
/bin/mkdir -p ~/Library/Developer/Xcode/.../Passer\ Rating.app 


SymLink ~/Library/Developer/Xcode/.../Passer\ Rating.app \ 
~/Library/Developer/Xcode/.../Applications/Passer\ Rating.app 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
/bin/ln -sfh ~/Library/Developer/Xcode/.../Passer\ Rating.app \ 
~/Library/Developer/Xcode/.../Applications/Passer\ Rating.app 


构建 系统 从 创建 根 构建 目录 和 arm64 以 及 armv7 架 构 的 子 目 录 开 始 ， 并 初始 化 了 一 些 临 时 文件 。 它 创建 了 应 用 程序 包 (ic 
住 ， 它 只 是 一 个 市 有 .app 后 缀 的 目录 ) ， 并 完成 了 内 部 链接 。 


构建 过 程 的 每 个 阶段 都 由 一 段 “ 调 用 ”的 伪 合 令 开始 ， 它 会 介绍 下 面 这 一 段 命令 的 用 途 ， 这 段 命令 中 包含 实现 你 的 意图 的 实 
际 命令 行 调 用 。 你 会 友 现 大 部 分 构建 进程 使 用 的 都 是 外 部 工具 ， 而 不 是 Xcode IDE 目 身 的 方法 。 


在 本 例 中 ， 伪 命令 行 是 yymLink。Xcode 使 用 了 标准 的 In 命令 执行 链接 工作 ， 但 是 要 注意 ， 在 构建 系统 调用 任意 命令 行 工具 
之 前 ， 它 总 是 将 PATH 环境 变量 设置 为 包含 Xcode 当 前 SDK 的 /usrbin 路 径 下 ， 执 行 完毕 后 再 将 PATH 切换 为 系统 路 径 。 


CompileSwiftSources normal arm64 com.apple.xcode.tools.swift.compiler 

cd "~/projects/Passer Rating" 

export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin: /usr/sbin:/sbin" 

Xcode.app/.../swiftc -target arm64-apple-ios8.2 \ 
-module-name Passer_Rating \ 
-O -D ALWAYS_DELETE_STORE \ 
-sdk Xcode.app/.../SDKs/iPhoneOS8.2.sdk -g \ 
-module-cache-path ~/Library/Developer/DerivedData/ModuleCache \ 
-I ~/Library/Developer/.../BuildProductsPath/Release-iphoneos \ 
-F ~/Library/Developer/.../BuildProductsPath/Release-iphoneos -c \ 
-j4 ~/Target-Folder/AppDelegate.swift \ 
~/Target-Folder/mogenerated/Game.swift \ 
~/Target-Folder/PasserEditController.swift \ 
~/Target-Folder/PasserListController.swift \ 
~/Target-Folder/SimpleCSVFile.swift ~/Target-Folder/StatView.swift \ 
~/Target-Folder/rating.swift \ 
~/Target-Folder/mogenerated/_Passer.swift \ 
~/Target-Folder/PasserEditTableController.swift \ 
~/Target-Folder/Extensions.swift \ 
~/Target-Folder/mogenerated/Passer.swift \ 
~/Target-Folder/Utilities.swift \ 
~/Target-Folder/mogenerated/_Game.swift \ 
~/Target-Folder/GameListController.swift \ 
-output-file-map \ 


~/Library/Developer/.../Passer\ Rating-OutputFileMap.json \ 
-parseable-output -serialize-diagnostics \ 
-emit-dependencies -emit-module \ 
-emit-module-path \ 
~/Library/Developer/.../Passer_Rating.swiftmodule \ 
-Xec -I~/Library/Developer/.../swift-overrides.hmap \ 
-Xcc -iquote -Xcc \ 
~/Library/Developer/.../Passer\ Rating-generated-files.hmap \ 
-Xec -I~/Library/Developer/.../Passer\ 


Rating-own-target-headers.hmap \ 
-Xcc -I~/Library/Developer/.../Passer\ 
Rating-all-target-headers.hmap \ 
-Xcc -iquote \ 
-Xcc ~/Library/Developer/.../Passer\ 
Rating-project-headers.hmap \ 
-Xcc -I~/Library/Developer/.../include \ 
-Xcc -IXcode.app/.../usr/include \ 
-Xcc -I~/Library/Developer/.../DerivedSources/arm64 \ 
-Xec -I~/Library/Developer/.../DerivedSources \ 
-emit-objc-header -emit-objc-header-path \ 
~/Library/Developer/.../Passer_Rating-Swift.h 


Swift 怎 么 知道 你 项 目 中 使 用 的 Swift 文 件 是 否 在 代码 中 有 交叉 引用 ? 简单 点 说 : 它 一 次 性 编译 所 有 的 文件 ， 在 一 次 调用 中 将 
所 有 的 文件 都 传 入 编译 器 中 。 在 构建 的 过 程 中 ，swiftc， 也 就 是 Swift 编译 器 ， 它 会 忽略 hmap 文 件 ; 扩展 名 表示 它 是 一 个 
header map， 它 的 作用 惑 是 记录 源 文件 之 间 的 相互 依赖 还 有 交叉 引用 。 


swiftc 调 用 的 最 后 两 个 开关 用 来 询问 Objective-C 头 文件 和 PasserRatingSwifth。 它 是 允许 在 Objective-C 中 访问 Swift 代码 
的 基本 条 件 : 首先 你 获得 了 各 个 模块 的 -Swift.h 头 文件 ; 所 有 需要 使 用 Swift.h 头 文件 的 ObjC 代 码 只 需要 使 用 #include 命 令 包含 
它 ， 然 后 残 可 以 继续 工作 ， 下 面 是 一 个 简单 的 例子 : 


SWIFT_CLASS ("_TtC13Passer_Rating8StatView") 
@interface StatView : UIView 

@property (nonatomic, copy) NSString * name; 
@property (nonatomic) NSInteger value; 


@property (nonatomic) double fontSize; 
(instancetype) initWithFrame: (CGRect)frame OBJC_DESIGNATED_INITIALIZER; 


(instancetype) initWithCoder: (NSCoder *)aDecoder \ 
OBJC_DESIGNATED_INITIALIZER; 
(void) layoutSubviews; 
(CGSize) intrinsicContentSize; 
@end 


头 文件 重新 声明 了 Swift 模 块 中 所 有 使 用 @objc 和 public 标 记 的 结构 。 如 果 部 分 方法 或 者 数据 结构 没有 转化 到 Objective-C 模 


R, 那么 它们 就 无 法 桥接 。 


- 


注意 @interface 的 前 面 有 一 个 “托管 ”的 类 名 ，_TtC13Passer Rating8StatView，Swift 的 源 代码 符号 在 模块 、 泛 型 类 型 和 
国 数 釜 名 之 间 有 很 多 重复 的 ; 之 后 它们 将 会 被 送 到 链接 器 或 者 其 他 语言 分 析 工 具 和 需要 名 称 显 式 区 分 的 工具 中 。 比 如 
C++，Swift 将 所 有 的 限定 符 放 到 一 个 包含 名 称 和 限定 符 的 字符 串 中 。 你 可 以 将 这 个 字符 串 传递 到 swift-demangle 工 具 中 恢复 用 
户 可 读 的 名 称 (使 用 xcrun 才 能 用 这 个 工具 ) 。 


$ xcrun swift-demangle _TtC13Passer_Rating8StatView 
_TtC13Passer Rating8StatView ---> Passer _Rating.StatView 


Bate PARI MT i: 


CompileSwiftSources normal armv7 com.apple.xcode.tools.swift.compiler 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 


Xcode.app/.../swiftc -target armv7-apple-ios8.2 \ 
-module-name Passer Rating 


AN 一 一 


这 样 做 看 起 来 之 无 理由 ， 和 直到 你 友 现 伪 命 令 中 的 不 同 : 第 一 次 调用 是 用 来 将 源 代 码 编译 成 arm64 处 理 器 能 够 处 理 的 指令 ; 这 
一 次 ，target 是 armv7。 针 对 每 种 处 理 器 都 需要 专 | ] 构 建 一 一 Debug 配 置 加 快 构建 速度 的 一 个 方法 就 是 只 编译 针对 一 种 处 理 器 
架构 的 代码 。 


Ditto ~/Library/Developer/.../DerivedSources/Passer_Rating-Swift.h \ 
~/Library/Developer/.../arm64/Passer_Rating-Swift.h 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin: /usr/sbin:/sbin" 
/usr/bin/ditto \ 
-rsrc ~/Library/Developer/.../arm64/Passer_Rating-Swift.h \ 
~/Library/Developer/.../DerivedSources/Passer_Rating-Swift.h 


Ditto ~/Library/Developer/.../DerivedSources/Passer_Rating-Swift.h \ 
~/Library/Developer/.../armv7/Passer_Rating-Swift.h 


最 新 制作 的 桥接 头 文件 移动 到 了 更 万 便 的 目录 。Ditto 命 令 与 cp 复制 命令 类 似 ， 其 中 带 有 排除 版 本 控制 目录 的 选项 ， 还 有 处 
理 扩展 兼容 属性 的 选项 。 


DataModelVersionCompile \ 
~/Library/Developer/.../Passer\ Rating.app/Passer_Rating.momd \ 
Passer\ Rating/Passer_Rating.xcdatamodeld 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
Xcode.app/Contents/Developer/usr/bin/momc \ 
-XD_MOMC_SDKROOT=Xcode.app/.../SDKs/iPhoneOS8.2.sdk X 
-MOMC_PLATFORMS iphoneos ~/Target-Folder/Passer_Rating.xcdatamodeld \ 
~/Library/Developer/.../Passer\ Rating.app/Passer_Rating.momd 


Passer Rating 在 运行 时 使 用 的 .mom 文 件 从 数据 模型 设计 中 编译 。 


Ld ~/Library/Developer/.../Passer\ Rating normal armv7 

cd "~/projects/Passer Rating" 

export IPHONEOS DEPLOYMENT TARGET=8 .2 

export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 

Xcode.app/.../clang -arch armv7 \ 
-isysroot Xcode.app/.../SDKs/iPhoneOS8.2.sdk 
-L~/Library/Developer/.../BuildProductsPath/Release-iphoneos \ 
-F~/Library/Developer/.../BuildProductsPath/Release-iphoneos \ 
-filelist ~/Library/Developer/...Passer\ Rating.LinkFileList \ 
-Xlinker -rpath -Xlinker @executable_path/Frameworks -dead_strip \ 
-LXcode.app/.../usr/lib/swift/iphoneos -Xlinker -add_ast_path \ 
-Xlinker ~/Library/Developer/.../armv7/Passer_Rating.swiftmodule \ 
-miphoneos-version-min=8.2 -framework MapKit \ 
-framework NetworkExtension \ 
-Xlinker -dependency_info \ 
-Xlinker \ 

~/Library/Developer/.../Passer\ Rating_dependency_info.dat \ 

-o ~/Library/Developer/.../Passer\ Rating 


Lad ~/Library/Developer/.../Passer\ Rating normal arm64 
cd "~/projects/Passer Rating" 
export ITPHONEOS_DEPLOYMENT TARGET=8 .2 


export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 


Xcode.app/.../clang -arch armé4 \ 
-isysroot Xcode.app/.../SDKs/iPhoneOS8.2.sdk 


下 面 束 是 链接 器 将 模块 和 系统 框架 之 间 的 引用 建立 起 来 。 注 意 ， 这 里 跟前 面 一 样 ， 每 种 处 理 器 都 要 执行 一 遍 这 个 操作 。 


我 们 使 用 的 是 clang 《语言 编译 器 。 当 到 达 链 接 阶 段 的 时 候 ， 你 的 代码 已 经 失去 了 所 有 Swift 形式 的 属性 一 ENNER 
符号 混淆 的 二 进 制 率 引 。 


Ditto ~/Library/Developer/.../Passer_Rating.swiftmodule/arm.swiftmodule \ 
~/Library/Developer/.../Passer_Rating.swiftmodule 


Ditto ~/Library/Developer/...Passer_Rating.swiftmodule/arm.swiftdoc \ 
~/Library/Developer/.../Passer_Rating.swiftdoc 


Swift 模块 的 接口 会 进入 .swiftmodule 目 录 下 的 .swiftmodule 和 .swiftdoc 文 件 中 。Ditto 工 具 会 将 它们 组 合 在 一 起 。 每 种 架 
构 对 应 一 个 包 。 


CreateUniversalBinary \ 


~/Library/Developer/.../Passer\ Rating.app/Passer\ Rating \ 
normal armv7\ arm64 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
Xcode.app/.../lipo \ 
-create ~/Library/Developer/.../Passer\ Rating \ 
~/Library/Developer/.../Passer\ Rating \ 
-output ~/Library/Developer/.../Passer\ Rating.app/Passer\ Rating 





当 “ 全 部 ”一 一 二 进 制 文件 铸 称 为 “ 胖 ” 二 进 制 文件 的 时 候 ， 融 创建 了 lipo 工 具 。 它 市 有 相同 的 库 和 可 执行 广 
件 ， 但 是 针对 不 同 的 架构， 将 它们 打包 成 单个 的 文件 ， 操 作 系统 会 根据 需要 选择 对 应 的 版 本 。 在 这 个 例子 中 ， 包 含 armv7 和 
arm64 两 种 架构 的 二 进 制 文件 。 


PhaseScriptExecution Generate\ Test\ Data \ 
~/Library/Developer/.../Script-...990D.sh 
cd "~/projects/Passer Rating" 
/bin/sh -c \"~/Library/Developer/.../Script-...990D.sh\" 


CpResource Passer\ Rating/sample-data.csv \ 
~/Library/Developer/.../Passer\ Rating.app/sample-data.csv 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin: /bin: /usr/sbin:/sbin" 
builtin-copy -exclude .DS_Store -exclude CVS -exclude .svn \ 
-exclude .git -exclude .hg -strip-debug-symbols \ 
-strip-tool Xcode.app/.../strip -resolve-src-symlinks \ 
~/Target-Folder/sample-data.csv \ 


~/Library/Developer/.../Passer\ Rating.app 


这 些 伪 命令 执行 了 Generate Test Data 脚 本 ， 并 将 生成 的 sample-data.csv 文 件 放 到 应 用 程序 包 中 。 它 仅仅 是 一 个 文本 文 
件 ， 但 是 builtin-copy“ 工 具 ” 会 去 除 附 加 的 文件 ， 移 除 不 需要 的 符号 信息 ， 并 且 确 保 符 号 链接 的 清洁 。 


CompileStoryboard Passer\ Rating/Base.lproj/Main.storyboard 

cd "~/projects/Passer Rating" 

export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 

export XCODE_DEVELOPER_USR_PATH=Xcode.app/Contents/Developer/usr/bin/.. 

Xcode.app/Contents/Developer/usr/bin/ibtool --target-device iphone \ 
--errors --warnings --notices --module Passer_Rating \ 
--minimum-deployment-target 8.2 --output-partial-info-plist \ 
~/Library/Developer/Xcode/.../Main-SBPartialInfo.plist \ 
--auto-activate-custom-fonts --output-format human-readable-text \ 
--compilation-directory \ 

~/Library/Developer/Xcode/.../Passer\ Rating.app/Base.lproj \ 

~/Target-Folder/Base.lproj/Main.storyboard 


/* com.apple.ibtool.document.warnings */ 

~/Target-Folder/Base.lproj /Main.storyboard:aD1-LC-OKV: 
warning: Constraint referencing items turned off \ 
in current configuration. \ 


Turn off this constraint in the current configuration. 


storyboards 也 对 应 一 个 编译 阶段 。 这 个 步骤 生成 了 一 个 警告 ， 涉 及 的 元 素 前 面 会 附加 源 文 件 的 路 径 名 和 对 和 象 ID (如 果 问 题 
源 于 是 文本 代码 ， 那 么 这 个 地 方 将 会 显示 行 号 ) 。Xcode IDE 会 将 它们 生成 黄色 的 标记 ， 指 向 问题 所 在 位 置 的 链接 以 及 对 应 的 消 


/LO 


CompileAssetCatalog ~/Library/Developer/Xcode/.../Passer\ Rating.app \ 
Passer\ Rating/Images.xcassets 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin: /bin: /usr/sbin: /sbin" 
Xcode.app/Contents/Developer/usr/bin/actool \ 
--output-format human-readable-text --notices --warnings \ 
--export-dependency-info \ 
~/Library/Developer/.../assetcatalog_dependencies.txt \ 
--output-partial-info-plist \ 
~/Library/Developer/.../assetcatalog_generated_info.plist \ 
--app-icon AppIcon --launch-image LaunchImage \ 
--platform iphoneos --minimum-deployment-target 8.2 \ 
--target-device iphone --compress-pngs \ 
--compile ~/Library/Developer/.../Passer\ Rating.app \ 
~/Target-Folder/Images.xcassets 


2014-11-22 20:51:13.416 IBCocoaTouchImageCatalogTool [21763:1375516] \ 
CoreUI (DEBUG): CSIGenerator using LZVN Compression coreui 
/x com.apple.actool.document.notices x*/ 
~/Target-Folder/Images.xcassets: \ 
. /LaunchImage. launchimage/ [iphone] [736h] [3x] [portrait]...: \ 
notice: This launch image only applies to iOS 6.x and prior \ 
but the minimum deployment is 7.0 or later. 
/* com.apple.actool.compilation-results */ 
~/Library/Developer/.../Passer Rating.app/AppIcon29x29@2x.png 
~/Library/Developer/.../Passer Rating. app/AppIcon29x29@3x.png 


~/Library/Developer/.../Passer Rating.app/LaunchImage-800-667h@2x.png 


~/Library/Developer/.../Passer Rating.app/Assets.car 





Asset 目 录 将 会 根据 需求 选取 其 中 的 资源， 并 且 按 照 运行 时 更 有 效率 访问 的 方式 排列 。 处 理 方 式 中 包含 将 PNG 文 件 转化 为 
种 合法 但 是 部 分 图 形 应 用 却 无 法 查看 的 格式 。 如 果 你 翻 一 翻 iOS 的 .app 包 ， 当 看 到 无 法 查看 的 PNG 文 件 的 时 候 不 要 惊讶 。 


目录 编译 器 列 出 了 一 系列 图 片 相关 的 问题 ， 当 前 的 图 片 无 法 用 于 那些 不 能 在 iIOS 6 或 者 更 早 的 操作 系统 上 运行 的 应 用 以 及 处 
理 过 的 图 片 列表 。Xcode 1DE 不 会 全 部 显示 ， 但 是 你 可 以 在 完整 的 文本 记录 中 得 看 ， 或 者 企 Report 导 舰 器 中 展开 日 志 ， 也 能 


到 完整 的 步骤 。 


ProcessInfoPlistFile \ 
~/Library/Developer/.../Passer\ Rating.app/Info.plist \ 
Passer\ Rating/Info.plist 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
builtin-infoPlistUtility ~/Target-Folder/Info.plist \ 
-genpkginfo \ 
~/Library/Developer/.../Passer\ Rating.app/PkgInfo \ 
-expandbuildsettings -format binary -platform iphoneos \ 
-additionalcontentfile \ 
~/Library/Developer/.../Main-SBPartialInfo.plist \ 
-additionalcontentfile \ 
~/Library/Developer/.../assetcatalog_generated_info.plist \ 
-o ~/Library/Developer/.../Passer Rating.app/Info.plist 


我 已 经 告诉 过 你 很 多 次 ， 项 目 窗 口中 显示 的 Info.plist 仅 仅 是 最 终 放 入 app 的 前 置 文 件 。 下 面 就 是 转化 的 过 程 。 这 个 过 程 包含 
由 storyboard 提 供 的 信息 。 


(Main-SBPartialInfo.plist) and the asset catalog (assetcatalog- 
generated_infoplist). 


GenerateDSYMFile ~/Library/Developer/.../Passer\ Rating.app.dSYM \ 
~/Library/Developer/.../Passer\ Rating.app/Passer\ Rating 


Touch ~/Library/Developer/.../Passer\ Rating.app 
Stripping ~/Library/Developer/.../Passer\ Rating.app/Passer\ Rating 
SetOwnerAndGroup fritza:staff ~/Library/Developer/.../Passer\ Rating.app 


SetMode u+w,go-w,at+rX ~/Library/Developer/.../Passer\ Rating.app 


兴奋 之 情 已 经 慢 慢 平息 。Xcode 生 成 了 一 个 .dSYM 包 作为 App 调 试 信息 的 外 部 仓库 ;查看 App 确 保 它 比 任何 组 件 都 要 新 ; 从 
App 中 移 除 最 后 的 调试 信息 ; 最 后 设置 文件 系统 的 权限 。 


ProcessProductPackaging \ 
~/Library/MobileDevice/Provisioning\ Profiles/...0bca.mobileprovision \ 
~/Library/.../Passer\ Rating.app/embedded.mobileprovision 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
builtin-productPackagingUtility \ 
~/Library/MobileDevice/Provisioning\ Profiles/...0bca.mobileprovision \ 
~/Library/.../Passer\ Rating.app/embedded.mobileprovision 


Xcode AM Fate rix2l 7 RHEE, FHS CHEF. appa. 


CopySwiftLibs ~/Library/Developer/Xcode/.../Passer\ Rating.app 
cd "~/projects/Passer Rating" 
export ACTION=build 
export AD HOC CODE SIGNING ALLOWED=NO 
export ALTERNATE GROUP=staff 


export arch=arm64 
export variant=normal 
Xcode.app/.../swift-stdlib-tool --verbose --copy 


Copying libswiftCore.dylib from \ 
Xcode.app/.../usr/lib/swift/iphoneos to ...Passer Rating.app/Frameworks 
Copying libswiftCoreGraphics.dylib from \ 
Xcode.app/.../usr/lib/swift/iphoneos to ...Passer Rating.app/Frameworks 
Copying libswiftFoundation.dylib from \ 
Xcode.app/.../usr/lib/swift/iphoneos to ...Passer Rating.app/Frameworks 


IOS 7 和 OS X 10.9 没 有 为 Swift 生 成 代码 添加 内 建 的 支持 一 一 它们 没有 编译 过 的 二 进 制 依赖 的 运行 时 库 。 解 决 方案 是 将 运行 
时 蔚 入 应 用 程序 本 身 中 。 


CopySwiftLibs 的 伪 代 码 如 下 所 示 : 


Codesigning libswiftCore.dylib at .../Passer Rating.app/Frameworks 
/usr/bin/codesign '--force' '--sign' '376...780' '--verbose' \ 
./Passer Rating.app/Frameworks/libswiftCore.dylib' 
Codesigning libswiftCoreGraphics.dylib at .../Passer Rating.app/Frameworks 
/usr/bin/codesign '--force' '--sign' '376...780' '--verbose' \ 
../Passer Rating.app/Frameworks/libswiftCoreGraphics.dylib' 


一 个 接 一 个 ， 它 将 友和 布 签 名 应 用 到 所 有 复制 的 运行 时 库 。 


ProcessProductPackaging Passer\ Rating/Passer\ Rating.entitlements \ 
../Passer\ Rating.app.xcent 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
builtin-productPackagingUtility \ 
~/Target-Folder/Passer\ Rating.entitlements \ 
-entitlements -format xml -o .../Passer\ Rating.app.xcent 


CodeSign ~/Library/Developer/.../Passer\ Rating.app 
cd "~/projects/Passer Rating" 
export CODESIGN_ALLOCATE=Xcode.app/.../codesign_allocate 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
/usr/bin/codesign --force --sign 37...80 \ 
--entitlements ~/Library/Developer/.../Passer\ Rating.app.xcent \ 
~/Library/Developer/.../Passer\ Rating.app 


Validate ~/Library/Developer/.../Passer\ Rating.app 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
export PRODUCT_TYPE=com.apple.product-type.application 
Xcode.app/.../usr/bin/Validation \ 
~/Library/Developer/.../Passer\ Rating.app 


Touch ~/Library/Developer/.../Passer\ Rating.app.dSYM 
cd "~/projects/Passer Rating" 
export PATH="Xcode.app/.../usr/bin:/usr/bin:/bin:/usr/sbin:/sbin" 
/usr/bin/touch -c ~/Library/Developer/.../Passer\ Rating.app.dSYM 


现在 这 个 过 程 已 经 完成 ， 应 用 程序 已 经 声明 了 权限 ， 只 需要 允许 它 能 人 在 调试 器 的 管理 下 运行 即 可 。 
ProcessProductPackaging 俯 命令 生成 了 最 终 的 .entitlements 文 件 ， 并 将 它 放 在 应 用 程序 包 中 。 


签名 认证 将 会 作为 一 个 整体 应 用 于 .app 包 ， 然 后 产品 会 检查 一 任性 (这 个 过 程 与 你 企 将 应 用 程序 提交 到 应 用 商店 乙 前 要 进 
行 的 验证 不 同 ) 。 最 后 ,会 检查 .dSYM 调 试 符号 包 ， 将 它 的 修改 日 期 设置 为 当前 日 期 ， 所 以 它 不 会 重新 构建 ， 直 到 它 涉及 的 文 
FREEK 


Oe .dSYM 包 非常 重要 ， 即 使 本 文 说 的 是 发 布 相关 的 内 容 而 不 是 调试 相关 的 内 容 。 压 缩 后 的 二 进 制 文 件 〈.ipal) 
和 .dSYM 都 会 进入 文件 归档 中 ， 最 终 要 从 这 个 归档 中 获得 最 后 的 产品 。 ao 引 它 的 ID， 所 以 系统 能 将 调试 信息 和 任何 二 
进 制 数据 或 者 前 溃 报 告 匹配 在 一 起 。 衣 溃 报 告 中 将 不 会 包含 任何 应 用 程序 些 符 号 都 已 经 被 去 除了 。 如 果 Xcode 或 者 其 
他 工具 能 找到 对 应 的 符号 目录 ， 那 么 它 就 能 将 报告 “符号 化 ”为 可 理解 的 栈 信 息 。 所 以 总 是 要 保存 你 发 布 的 文件 归档 包 





25.11 小 结 


如 果 你 想 知 道 Xcode 的 工作 流程 ， 那 么 这 是 非常 重要 的 一 章 。 它 解释 了 Xcode 内 部 的 构建 系统 如 何 取 代 传 统 makefile 文 件 完 
成 构建 过 程 ， 以 及 保持 构建 系统 中 的 信息 最 新 所 做 的 努力 。 它 展示 了 构建 过 程 如 何 分隔 成 “包含 ”所 需要 处 理 文件 的 各 个 阶段 。 
编译 器 设置 和 其 他 工具 是 配置 构建 过 程 的 基本 部 分 ， 也 了 解 了 Xcode 如 何 通 过 project、target 和 配置 来 组 织 这 些 设置 。 


你 学 习 了 如 何 通 过 脚本 使 用 构建 系统 ， 所 以 不 用 在 1DE 中 手动 触 友 束 能 管理 构建 过 程 。 


最 后 ， 你 查看 了 Report 导 舰 器 ， 学 习 了 如 何 得 到 构建 过 程 中 所 执行 命令 的 记录 文本 ， 以 及 如 何 分析 这 个 记录 文本 。 


=326= Instruments 


Instruments 是 一 个 被 称 为 .instruments 的 软件 度量 工具 框架 (大 写 | 的 Instruments 代 表 的 是 一 个 应 用 程序 ， 小 写 i 的 
instruments 代 表 的 是 Instruments 应 用 程序 的 一 个 组 件 。) 与 之 类 似 的 是 多 轨 录 音 心 片 组 。Instruments 将 活动 记录 下 来 (每 个 
instrument 记 录 一 次 ) ， 然 后 将 数据 按照 时 间 线 组 织 ， 就 像 磁 带 上 面 的 音频 。 


在 第 16 章 中 ， 我 们 已 经 见 过 Instruments， 它 帮助 我 们 追踪 了 一 些 Passer Rating iPhone app 的 一 些 内 存 和 性 能 问题 。 你 已 
经 学 会 了 如 何 进 入 Instruments 记 录 窗 口 ， 以 及 如 何 根据 需要 选择 合适 的 instruments。 


26.1 Instruments 是 什么 


专注 于 时 间 线 让 Instruments 变 得 特别 。 以 前 ， 分 析 和 调试 工具 一 次 只 能 做 一 件 事 。 使 用 Shark (Xcode 2 和 3 可 用 ) 对 正在 
运行 的 应 用 程序 进行 采样 ， 然 后 收集 时 间 消 耗 情况 的 统计 信息 。Shark 提 供 了 多 种 模式 用 于 不 同 的 统计 信息 。 如 果 你 想 要 使 用 另 
外 一 种 模式 ， 需 要 重新 运行 Shark。Shark 的 分 析 数 据 源 于 整个 会 话 ; 如 果 你 想 要 分 析 应 用 程序 特定 时 间 内 的 数据 ， 有 一 个 热 键 
能 让 你 打开 或 者 天 闭 分 析 功 能 。 


有 一 个 分 析 应 用 程序 叫 作 MallocDebug， 它 会 持续 收集 对 malloc 和 free 调 用 的 统计 信息 。 统 计 结果 包含 整个 分 析 会 话 的 数 
据 ， 所 以 你 知道 内 人 存 分 配 的 最 大 块 或 者 最 频繁 的 地 方 在 哪里 ， 但 是 不 知道 这 些 分 配 操作 是 什么 时 候 开始 的 。 


如 果 你 需要 对 象 分 配 的 历史 和 分 布 ， 那 么 还 有 一 个 Object Alloc 应 用 程序 。 


如 果 你 想 知 道 应 用 程序 在 执行 分 配 操 作 时 的 时 间 消 耗 情 况 ， 那 么 丈 需 要 退出 MallocDebug 或 者 Object Alloc 程 序 ， 然 后 再 
使 用 Shark 运 行 目标 App， 因 为 这 些 应 用 的 功能 都 很 单一 。 


Instrument 不 一 样 。 它 是 一 个 绪 合 性 的 工具 ， 其 中 包含 很 多 不 同 的 iInstruments 按 照 不 同 的 方式 分 析 你 的 代码 ， 而 且 
Instruments 会 在 同一 时 间 运 行 这 些 instruments。 程 序 的 执行 结果 按照 时 间 显示 。 按 下 Compute 按 钮 融会 触 点 Core Data 获 取 
操作 吗 ? 还 是 说 获取 操作 很 早 束 已 经 完成 了 ? 还 有 其 他 的 磁盘 活动 会 消耗 市 完 吗 ? 在 应 用 程序 中 ? 还 是 系统 的 每 个 地 方 ? 应 用 程 
郭 会 泄露 文件 摘 述 街 吗 ?如果 泄 露 了 文件 摘 述 符 ， 那 么 是 什么 时 候 泄 露 的 ?在 哪里 上 友 生 的 泄露 ”如 果 你 正在 处 理 友 送 到 另外 一 个 
进程 的 数据 ， 那 么 接收 者 进程 的 内 和 存 更 改 情 况 如 何 ” 接 收 应 用 程序 和 主 应 用 程序 的 文件 摘 述 符 如 何 联系 在 一 起 ? 


Instruments 可 以 回答 这 些 问 题 。 你 可 以 将 文件 摘 述 符 与 磁盘 活动 联系 在 一 起 ， 将 磁盘 活动 和 Core Data 事 件 联 系 在 一 起 ， 
栈 信息 中 丈 会 分 别 记 录 这 些 内 容 ， 因 为 Instruments 会 根据 时 间 线 并 行 获取 数据 。 而 且 ， 你 也 能 同时 使 用 不 同 的 instrumentsts 
控 不 同 的 应 用 程序 (甚至 整个 系统 ) 。 


对 于 事件 一 一 比如 独立 的 内 存 分 配 或 者 系统 调用 一 一 来 说 ，Instruments 保 证 了 对 每 个 事件 进行 完整 的 数据 记录 。 对 于 时 间 
分 析 来 咒 ，Instrument 进 行 了 抽样 统计 ， 但 是 它 保存 了 每 个 样本 。 这 也 就 是 说 即使 你 想 要 一 个 集合 ， 那 么 束 选 择 聚 合 。 


据说 当 滚 动 Passer Rating 中 的 passer 列 表 时 ,会友 生 卡 顿 现象 。 借 助 Shark 启 动 Passer Rating， 迅 速 找 到 需要 浴 动 的 地 
方 ， 然 后 执行 滚动 操作 ， 最 后 迅速 天 | 为 Passer Rating， 这 样 你 的 抽样 统计 数据 就 不 会 被 后 面 的 操作 数据 污染 。 不 过 还 是 太 晚 
了 ， 因 为 CPU 时 间 会 被 初始 化 占用 ， 在 载 入 passer 表 单元 格 的 时 候 会 化 费 一 些 时 间 。 


SFR ”Shark 为 了 缓解 这 个 问题 ， 它 多 许 你 设置 开始 采样 的 延迟 ， 还 有 采样 的 持续 时 间 。 


在 Instruments 中 ， 你 不 用 担心 应 用 程序 会 污染 你 的 统计 信息 。 你 可 以 选取 执行 滚动 操作 时 对 应 的 时 | 间 片 ， 然 后 束 能 看 到 
App 此 时 正在 做 什么 。 


Oe Insttuments 最 强大 的 地 方 在 于 获得 记录 信息 后 ， 使 用 它 提 供 的 分 析 工 具 对 这 些 数据 进行 分 析 。 但 是 不 要 忽略 动态 
显示 程序 状态 的 优势 。 如 果 你 看 不 到 内 存 总 量 或 者 文件 LO 使 用 状况 的 增长 和 回落 ， 你 就 不 会 知道 应 当 在 什么 时 候 停 止 记录 分 
析 。 


26.2 运行 Instruments 


在 第 16 章 中 ， 你 通过 Xcode 的 Product 一 Profile (#1) 命令 ， 或 者 选择 Xcode 工 具 栏 左边 的 Action 按 钮 的 Profile 功 能 启动 
了 Instruments。 人 在 Scheme 编辑 器 的 Profile 面 板 中 ， 你 可 以 设置 记录 模板 。 它 还 有 一 个 快捷 方式 : 执行 局 动 分 析 的 手势 时 ， 按 
住 option 键 ， 那 么 融会 在 操作 执行 前 ， 首 先 看 到 ycheme 编 辑 器 的 Profile 面 板 。 因 为 分 析 功 能 已 经 集成 到 了 Xcode 的 工作 流 中 ， 
所 以 这 也 是 Instruments 最 音 见 的 使 用 方法 。 


对 于 一 些 专业 用 法 ， 你 可 能 并 不 满足 Profile 行 为 为 你 提供 的 几 个 模板 。Instruments 能 独立 运行 并 附加 在 应 用 程序 上 ， 你 也 
可 以 启动 任何 喜欢 的 instruments 用 于 记录 。 


Instruments 并 没有 在 Finder 的 任何 地 方 以 应 用 程序 的 方式 显示 。 与 其 他 的 开 友 者 工具 一 样 ， 它 也 保 仔 在 Xcode.app 
bundle 中 。Profile 构 建行 为 将 会 启动 Instruments 并 将 它 指向 target 应 用 程序 。 如 果 你 想 在 不 同 的 target (另外 一 个 App， 或 者 
一 个 运行 中 的 进程 ) 上 使 用 Instruments， 那 么 选择 Xcode 一 Open Developer Tool 一 Instruments。lnstruments 会 像 任 何其 
他 应 用 程序 一 样 正常 启动 。 它 的 图 标 会 显示 在 Dock 上 ,， 我 建议 你 将 它 固定 在 Dock 栏 上 : 在 图 标 上 右 击 ， 然 后 选择 
Options—Keep in Dock, 


= {Raw InstrumentshAe, CatSele—ThMS ( 称 为 记录 文档 ) ， 然 后 显示 一 个 市 有 常见 任务 模板 的 界面 ( 见 图 
26.1) 。Apple 提 供 的 模板 列表 能 在 本 章 后 面 的 26.7 节 中 找到 。 


Choose a profiling template for: El Luggage > | Mac Passer Rating.app 


Standard Custom Recent 


Multicore Network OpenGL ES Sudden System Trace 
Analysis Termination 


System Usage Time Profiler UI Recorder Zombies 


Time Profiler 
KN Performs low-overhead time-based sampling of processes running on the system's CPLis 





Open an Existing File... Cancel 


图 26.1 ” 当 你 在 Instruments 中 创建 一 个 新 的 记录 文档 的 时 候 ， 它 就 会 显 个 空 文档 和 选择 预先 安装 的 常见 任务 模板 的 界面 


? 


在 New Trace 帮助 界面 的 顶部 是 一 个 层级 菜单 ，Choose a profiling template for: 第 一 个 segment 可 以 让 你 选择 设 
一 一 你 的 计算 机 ; 已 连接 的 iDS 设 备 ; iOS Simulator 类 型 ; 或 者 如 果 你 将 目标 信息 保存 在 一 个 自 定 义 模 板 中 ， 那 么 这 些 选 项 将 
会 与 保存 的 target 一 人 致 。 当 记录 文档 打开 的 时 候 可 以 更 改 target。 


26.3 ”记录 文档 窗口 


记录 文档 窗口 的 初始 格式 非常 简单 : 上 面 是 一 个 工具 栏 ， 一 系 询 instruments 白 据 着 视图 的 主要 位 置 。 一 旦 将 数据 记录 到 文 
档 中 ， 这 个 窗口 束 会 变 得 非常 满 。 让 我 们 先 看 看 图 26.2， 看 这 个 窗口 都 有 哪些 组 成 部 分 
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[a NSApplicationMain 
图 26.2 ”一 个 典型 的 Instruments 窗 口 ， 一 旦 记录 了 数据 ，Extended Detail area (4A) 就 会 显示 出 来 。 我 将 会 介绍 带 有 数字 标记 的 部 


N 
分 


26.3.1 THe 


工具 栏 由 3 部 分 组 成 ， 包 含 5 个 主要 的 功能 。 左 边 的 @@ 控 件 控制 了 记录 和 目标 应 用 程序 的 执行 。 有 一 个 Pause 按 钮 用 于 暂停 和 
恢复 数据 收集 ，Record/Drive&Record/Stop 按 钮 用 来 局 动 或 者 停止 数据 收集 


Oza 当 你 开始 记录 数据 的 时 候 ， 通 常 都 会 要 求 提 供 管理 员 密 码 。 很 多 instruments 执 行 的 进程 监控 (deep monitoring) 是 
一 个 安全 漏洞 ， 系 统 会 要 求 你 提供 这 么 做 的 权限 。 


Target 选 择 器 指定 了 设备 和 instruments 可 以 作为 目标 的 所 有 进程 ， 除 非 你 分 别 为 各 个 instruments 指 定 不 同 的 上 目标。 这些 


选择 如 下 : 


菜单 的 第 一 个 segment 允 许 你 选择 一 个 设备 ， 设 备 即 可 以 是 计算 机 也 可 以 是 连接 到 计 和 草 机 的 移动 设备 。 第 二 个 segment 将 会 
根据 设备 而 适 的 tafget。 





将 会 从 目标 设备 上 收集 所 有 用 户 和 系统 的 进程 数据 。 比 如 ，Cote Datainstruments ( 仅 在 Mac 上 有 效 ) 能 够 
测量 所 有 进程 上 的 Core Data 活 动 。 并 不 是 所 有 的 instrument 都 能 跨 进 程 收集 数据 。 如 果 你 的 文档 不 包含 能 够 在 系统 范围 内 采样 的 


- All Processes 


instrtuments， 这 个 选项 会 被 禁止 。 


- Chose Target… 一 一 将 会 出 现 一 个 界面 ， 里 面 有 一 个 浏览 器 可 以 选择 目标 二 进 制 文件 。 里 面包 含 应 用 程序 、 动 态 库 、 扩 展 
和 那些 可 能 由 daemons 启 动 的 进程 。 





它 会 出 现 一 个 Choose Target… 的 界面 ， 焦 点 会 在 你 为 记录 文档 设置 的 可 执行 程序 中 。 在 这 里 ， 可 以 
设置 启动 时 传递 给 目标 的 参数 和 环境 变量 。 


* Edit target name: +: 





- Recent Executables 


里 面 显 示 的 都 是 最 近 检 查 过 的 应 用 程序 和 其 他 进程 。 








- App Extensions 里 面 显示 的 都 是 将 自己 注册 到 系统 的 扩展 插件 。 
- Running Applications 正如 名 称 包含 的 意思 一 样 ， 里 面 显示 的 都 是 运行 中 的 应 用 程序 。 数 据 将 会 从 正在 运行 的 应 用 程序 


中 收集 ; 在 子 菜单 中 选择 它 。 有 些 instruments 要 求 它们 的 targets 需 要 从 Instruments 中 启动 ， 而 不 能 附加 到 正在 运行 的 进程 中 。 如 果 


你 使 用 的 是 (无 法 附加 ) non-attaching 的 instrtuments， 那 么 这 一 部 分 将 会 禁用 。 





- System Processes 同样 ， 当 前 运行 的 系统 守护 进程 会 在 后 台 运 行 。 你 首先 看 到 的 是 当前 最 活跃 的 进程 。 如 果 选 择 
Morehttp://www.hzcourse.com/resource/rteadBook?path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.. 这 个 选 


项 ， 那 么 菜单 中 将 会 显示 所 有 正在 运行 的 系统 进程 。 
当 Instruments 正 在 记录 的 时 候 ，Target 绅 出 窗口 无 法 选中 。 


当 记录 正在 进行 的 时 候 ， 这 个 地 方 的 时 钟 @ 将 会 显示 文档 中 记录 的 总 时 间 。 否 则 ， 它 将 会 在 Track 区 域 (图 26.3) 的 顶部 按 
照 时 间 尺 度 显 示 三 角形 的 “playback head” 滑动 器 。 退 踩 文 档 中 可 以 仓储 多 个 退 踩 记录 ; 单 击 左 侧 的 提示 三 角 显 示 之 前 的 运行 
记录 。 时 钟 显示 的 是 当前 选中 的 target 的 运行 记录 。 


MPR time & Core Data 
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图 26.3 ”追踪 文档 左边 的 工具 栏 显 示 了 一 个 时 钟 ， 还 有 选择 并 运行 要 被 追踪 的 主 tatget 的 控件 。 时 钟 视 图 了 进程 记录 的 持续 时 
间 。 当 停止 记录 的 时 候 ， 时 间 上 面 将 会 显示 一 个 playback head 三 角 。 如 果 有 多 个 正在 运行 的 target， 它 也 会 显示 正在 运行 的 那个 


target 的 信息 


你 可 以 使 用 View 菜 单 中 的 Previous Run (¢Quote) 和 Next Run (éApostrophe) 命令 在 正在 运行 的 target 之 间 切 换 ， 
而 不 用 展开 记录 。 


工具 栏 的 右边 提供 了 用 于 显示 的 万 便 的 控件 。 
LibraryG@ 有 一 个 + 按钮 ， 显 示 或 者 隐藏 了 可 用 instruments 面 板 ， 你 可 以 将 这 些 instrument 拖 动 到 Track 区 域 。 


Strategy 控 件 @ 可 以 在 Trace 区 域 选 择 观 察 方式 。 


- 从 中 间 的 segment 开 始 比 较 容 易 ，Insttruments ， 为 Time 的 显示 最 直观 : 每 个 instrument 有 它 自 己 的 记录 ， 它 能 显示 整个 进 


程 瞬时 的 统计 信息 。 
` CPU， 第 一 个 segment， 将 instrument 的 记录 分 离开 ， 按 照 负责 时 间 的 处 理 器 显示 收集 的 数据 。 


Threads 也 会 分 离 instrument 数 据 ， 但 它们 是 按照 处 理 时 间 的 子 进程 来 区 分 记录 ; 线程 在 整个 生命 周期 内 并 非 局 限于 单 核 ， 
通常 会 根据 各 自 的 目的 创建 各 自 的 线程 ， 它 能 让 你 粗略 地 根据 创建 目的 来 分 析 事 件 。 


SEE CPU 和 线程 视角 并 非 对 每 个 instrument 都 有 效 。 


Detail 选 择 器 @ 融 像 Xcode 工 具 栏 中 的 显示 项 目 窗口 中 的 特殊 区 域 的 控件 。 第 一 个 segment 可 以 显示 或 者 隐藏 Detail 区 城 
@ODD， 它 显示 了 原始 记录 数据 后 面 的 数据 ， 它 也 用 于 配置 instrument， 过 滤 数据 ， 并 显示 事件 的 追踪 信息 和 统计 集合 。 


26.3.2 ”记录 区 域 


Track 区 域 @ 是 文档 窗口 的 中 心 ， 它 也 是 当 文 档 首次 打开 的 时 候 唯 一 能 看 见 的 组 件 。 你 可 以 将 新 的 instruments 拖 入 这 个 区 
域 。Apple 将 Track 区 域 分 为 了 两 部 分 : 左边 的 Instruments Pane 和 右边 的 Track pane。 为 了 清晰 起 见 ， 我 避免 使 用 
instruments 的 另外 一 层 意思 ， 而 是 将 奶 踪 行 视 为 独立 的 单元 ， 它 的 左边 有 一 个 名 称 区 域 ， 右 边 有 一 个 记录 区 域 。 


如 果 你 选择 了 记录 的 一 个 时 间 段 ， 那 么 绝 大 部 分 instruments 将 会 显示 收集 的 数据 子 集 。 为 了 做 到 这 一 点 ， 在 你 感 兴趣 的 时 
间 栏 上 拖 动 playback head。 这 段 区 域 就 会 高 亮 显 示 ，Detail 区 域 @O 中 相应 的 也 只 显示 这 个 时 间 段 内 的 数据 信息 。 单 击 Track 区 
域 的 任意 位 置 可 以 清除 选中 状态 。 


有 的 时 候 ， 你 对 应 用 程序 运行 过 程 中 的 性 能 信息 图 形 感 兴趣 ;有 的 时 候 你 需要 查看 与 App 单 独 交 互 的 事件 序列 ; 你 可 能 甚至 
会 对 1 毫秒 内 的 处 理 器 事件 感 兴趣 。 不 同 的 事件 需要 不 同 的 度量 标准 。 


Track 区 域 的 尺度 可 以 由 配置 区 域 下 方 看 起 来 像 滑动 条 的 控件 控制 。 事 实 上 ， 它 的 行为 类 似 于 控制 杆 : 当 你 将 控制 杆 向 左 移 
动 的 时 候 ， 显 示 的 记录 融会 被 压缩 ; 当 控 制 杆 向 右 移 动 的 时 候 ， 记 录 融 会 展开 。 


按 下 一 个 辅助 功能 键 并 在 Track 区 域 中 拖 动 也 能 更 改 尺度 : shift-dragging ( 按 下 shift 拖 动 ) 会 将 你 选中 的 间隔 放大 到 窗口 
ABATE. control-dragging ( 按 下 control 键 拖 动 ) 将 会 缩小 。 拖 动 的 位 置 和 方向 没有 关系 。 


选择 View 一 Snap Track to Fit (^ ¢6Z) 将 会 缩放 Track 区 域 ， 所 以 整个 记录 将 会 与 窗口 同 宽 。 


你 也 可 以 在 垂直 方向 上 缩放 追踪 记录 ， 只 需要 使 用 View 菜 单 中 的 Decrease Deck Size (d-) 命令 或 者 Increase Deck 
Size (Æ+) 即 可 。 


名 称 区 域 显示 了 instrument 的 名 称 和 图 标 。 左 边 的 提示 三 角 能 让 你 看 到 这 个 instrument 之 前 运行 的 记录 。 想 要 更 改 
instrument 任 务 的 失 直 次 序 ， 只 需要 在 名 称 区 域 拖 动 对 应 的 名 称 即 可 。 你 无 法 将 一 个 instrument 拖 动 到 文档 外 部 。 如 果 你 想 要 
删除 一 个 追踪 记录 ， 那 么 就 单 击 名 称 区 域 选中 这 个 追踪 记录 ， 然 后 按 delete 键 即 可 。 


名 称 区 域 的 右 侧 显示 了 instrument 收 集 的 数据 的 时 间 线 。 大 部 分 instruments 有 很 多 选项 可 以 决定 收集 什么 数据 ， 以 及 如 何 
收集 数据 。 在 你 运行 第 一 次 追踪 之 前 (如 果 你 有 这 个 机 会 一 一 如 果 在 Xcode 中 执行 相关 操作 ， 那 么 Instr uments 会 立即 启动 并 追 
味 数 据 ) ， 请 检查 Settings 查 看 器 (Extended Detail 区 域 中 的 第 一 个 选项 卡 ) 中 每 个 instrument 的 配置 ， 看 看 将 要 得 到 的 结 
是 否 是 你 想 要 的 结果 。 你 可 以 在 运行 期 间 更 改 配 置 。 


26.3.3 Detail 区域 


当 运 行 一 次 跟踪 记录 的 时 候 ，Detail 区 域 @ 束 会 显示 出 来 。 单 击 工具 栏 中 Detail 选 择 器 的 第 一 个 segment 显 示 它 。 


当 你 在 Track 视 图 中 选择 了 一 个 instrument 的 时 候 ， 该 instrument 收 集 的 数据 束 会 按照 表格 的 形式 显示 在 Detail area 中 。 
不 同 instrument 对 应 的 表 内 容 也 不 一 样 ， 多 数 instruments 都 有 几 个 各 种 类 型 的 表 。Detail 跳 转 栏 @ 中 的 以 第 一 个 segment 挥 制 
显示 那个 表 。 随 着 你 查看 细节 行 中 的 数据 ， 元 素 就 会 添加 到 跳 转 栏 中 。 单 击 高 级 别 的 元 素 就 会 进入 对 应 的 视图 。Display 
Settings 查 看 器 (Extended Detail 区 域 中 的 第 二 个 选项 卡 ) 提供 了 过 滤器 进一步 过 滤 当 前 显示 的 表 。 


26.3.4 Extended Detail 区 域 


Extended Detail 区 域 @ 由 3 个 选项 卡 组 成 ， 基 本 对 应 你 分 析 应 用 程序 的 3 个 阶段 。 
- Record Settings 配 置 一 个 insttument 准 备 开 始 一 次 记录 的 运行 。 
Display Settings 提 供 了 在 Detail 区 域 中 显示 的 过 滤器 。 


- Extended Detail 在 Detail 表 中 根据 一 些 基准 显示 扩展 的 内 容 。 


Record Settings 


Record settings 选 项 卡 用 于 配置 企 Trace 区 域 选 中 的 instrument。 每 个 instrument 都 有 它 自己 的 配置 选项 ， 但 是 有 部 分 选 


项 对 于 大 多 数 instr ument 都 通用 。 
人 在 Track Display 部 分 中 ， 有 两 个 分 组 : Style 和 Type。 
通常 Style 菜 单 用 来 选择 instrumenti 记 录 的 数字 数据 的 图 形 风 格 。 它 们 可 能 包含 : 
- Line Graph 追踪 记录 会 显示 为 有 颜色 的 线 ， 连 接收 集 的 各 种 数据 中 的 各 个 数据 。 
- Filled Line Graph 与 Line 类 似 ， 只 是 线 下 的 区 域 按 照 颜 色 显 示 。 
- Point Graph， 追踪 记录 中 每 个 数据 都 显示 为 离散 的 符号 。 


- Block Graph 是 一 个 柱状 图 ， 将 每 种 数据 按照 不 同 颜色 的 长 方形 显示 。 在 记录 事件 的 instruments 中 ， 柱 状 图 的 宽度 是 两 次 事 


件 之 间 的 时 间 客 度 。 


- Peak Graph 显示 由 记录 事件 的 Instrument 收 集 的 数据 《比如 Core Datainstrument) ， 每 个 事件 对 应 一 条 重 直 的 线 。 每 当 有 事 


件 发 生 的 时 候 ， 图 形 就 会 显示 一 个 标记 。 


- Stack Libtaties 为 insttument 度 量 的 每 个 事件 都 绘制 了 一 个 柱状 图 。 柱 状 图 的 高 度 依赖 于 对 应 的 事件 调用 堆栈 的 深度 。 柱 状 图 
被 分 隔 成 带 有 颜色 的 segments， 每 个 库 都 带 有 不 同 的 闫 色 ， 这 个 库 拥有 那个 等 级 的 调用 者 。 


部 分 instrtuments 有 它 自 己 的 图 形 风 格 。Time Profiler insttument 有 3 种 自 定 义 的 风格 : 
CPU Usage 是 一 种 传统 格式 ， 它 是 实时 显示 所 有 处 理 器 核心 当前 时 间 需 求 的 区 域 图 。 


- Deepest Stack Libraries 显 示 的 是 一 个 柱状 图 ， 图 形 的 高 度 代 表 当 前 调用 栈 的 深度 ， 柱 状 图 有 各 种 各 样 的 颜色 ， 以 区 分 栈 
中 每 个 调用 的 责任 。 颜 色 的 代码 与 在 Extended Detail 区 域 中 使 用 的 颜色 代码 一 致 。 


- User and System Libraries 与 柱状 图 相同 , 但 是 它 只 有 两 种 颜色 ， 显 示 了 栈 中 有 多 少 调 用 传递 给 了 系统 库 。 


- 所 有 与 分 配 相 关 的 instrtument 都 有 3 种 自 定 义 风 格 : 
- Current Bytes 是 区 域 图 ， 显 示 了 当前 有 多 少 内 存 正 在 使 用 。 


- Allocation Density 显 示 了 每 个 时 间 段 内 产生 了 多 少 分 配 。 当 你 的 应 用 程序 制造 了 执行 了 大 量 分 配 操作 后 ， 图 形 中 将 会 显 


示 一 个 顶峰 。 


- Active Allocation Distribution 过 滤 了 allocation-density 图 形 ， 显 示 了 那些 在 追踪 记录 结束 的 时 候 仍 然 存在 的 分 配 发 生 的 位 


Wiis 大 多 数 Instruments 记 录 事 件 ， 而 不 是 随时 间 变 化 的 总 量 。 事 实 上 ， 显 示 的 数据 可 能 黄 至 不 是 连续 变量 ， 而 仅仅 只 
是 一 个 标签 ， 类 似 线 程 或 文件 描述 符 的 ID。 这 种 显示 方式 现在 仍然 相当 实用 ， 比 如 ， 它 们 为 你 在 其 他 追踪 记录 中 检查 相 匹配 的 
数据 时 提供 了 标记 。Stack Libraries 也 很 好 用 ， 不 过 侧重 点 不 同 ， 它 在 不 常见 事件 的 调用 栈 中 识别 模式 方面 表现 优秀 。 


Type 菜单 为 instrument 提 供 了 两 种 选择 ， 它 们 可 以 记录 多 个 数据 集 。Overlay 在 单个 图 形 上 显示 了 所 有 的 序列 。 显 示 数 据 可 
能 会 重 玛 ， 但 是 按照 点 或 者 线 显 示 的 图 形 不 会 有 问题 ， 显 示 是 透明 的 ， 所 以 两 种 系列 不 会 相互 遮 善 。Sstacked 风 格 在 独立 的 条 形 


图 上 显示 ， 一 条 在 另 一 条 上 。 
你 可 以 更 改 Track Display 设 置 ， 即 使 instrument 已 经 收集 了 它 的 数据 。 


对 于 那些 可 以 收集 多 种 数据 的 instrument 来 说 ，Select statistics to list 部 分 为 每 个 可 用 的 数据 系列 显示 了 一 个 复 选 枉 ， 其 
中 有 一 个 弹出 窗口 用 来 选择 Point Graph 中 点 的 形状 ， 还 有 颜色 。 


SLEA 
显示 议 


显示 设置 选项 卡 会 在 你 收集 了 数据 后 ， 过 滤 表 的 内 容 。 选 项 根据 instrument 和 表 的 类 型 有 所 不 同 ， 但 是 大 部 分 instrument 
都 会 收集 调用 树 ， 选 项 中 也 会 有 一 项 Call Tree 部 分 。 调 用 树 显示 的 选项 如 下 : 





在 Allocation instrument 中 ， 通 常 调用 树 会 显示 任何 类 型 的 分 配 行 为 。 如 果 你 需要 知道 在 菜 个 函数 中 
分 配 了 多 少 内 存 ， 而 不 用 管内 存 分 配给 了 谁 ， 那 么 这 个 选项 非常 有 用 。 如 果 选 择 Separate by Category, AAA AMI RAED 
配 的 类 型 排序 。 你 可 以 扩展 符号 名 为 NSImage 的 那 一 行 ， 查 看 创建 OS X 图 片 对 象 的 代码 路 径 。 


- Separate by Category 





- Separate by Thread 一 一 调用 树 通常 会 被 合并 ， 而 不 管 调用 发 生 在 哪个 线程 。 按 照 线 程 区 分 调用 树 能 帮助 你 排除 不 感 兴趣 的 
线程 中 发 生 的 调用 。 
- Invert Call Tree 一 一 调用 树 默 认 (从 上 到 下 ) 展示 的 是 由 运行 时 开始 的 statt 函 数 或 者 main 函 数 ， 然 后 显示 一 层 层 的 调用 ， 直 





到 最 后 一 个 函数 ， 也 就 是 insttruments 记 孙 的 事件 。 匀 选 这 个 复 选 框 就 能 倒置 调用 树 ， 所 以 它们 会 从 下 向 上 显示 : 最 上 面 的 逊 数 是 
(Objective-C 应 用 程序 通 各 是 objc_msgSend 函 数 ) 事件 发 生 的 位 置 ， 后 面 是 一 层 层 的 调用 。 


- Hide Missing Symbols 





名 选 这 个 选项 将 会 隐藏 那些 不 带 有 调试 符号 的 函数 。 系 统 框架 中 的 大 多 数 库 都 会 包含 函数 对 应 的 
符号 ， 从 这 些 符 号 信息 中 至 少 能 知道 发 生 了 什么 。 (当然 ， 你 自己 的 代码 也 有 对 应 的 符号 ， 因 为 你 已 经 确保 Debug Information 


Formate 这 个 构建 设置 为 “DWARF with dSYM File” 一 -一 它 不 会 增 大 你 的 代码 尺寸 ) o 





它 会 跳 过 系统 库 的 函数 。 查 看 库 调 用 名 能 帮助 你 了 解 程序 现在 发 生 了 什么 ,但 是 如 果 你 正在 寻找 
想 要 的 代码 ， 那 么 你 可 能 就 不 想 看 到 库 函 数 名 了 。 这 个 选项 和 Invett Call Tree 配合 使 用 通常 会 告诉 你 代码 现在 正在 做 什么 。 
Objc_mssgSend 在 Cocoa 代 码 中 非常 常见 ， 在 栈 信息 中 看 到 这 个 函数 并 不 能 说 明 什 么 问题 ; 解析 调用 树 ， 深 入 查看 哪里 发 起 的 调用 
才能 告诉 你 所 有 的 事情 。 


- Hide System Libraries 





这 个 选项 会 让 所 有 对 一 个 函数 的 调用 都 集中 在 一 个 单独 的 条 目 中 。 递 归 调 用 除了 能 增加 调用 长 度 外 ， 
无 法 提供 其 他 更 有 用 的 信息 。 


- Flatten Recursion 





这 是 一 个 非常 有 用 的 过 滤器 ， 但 是 很 难 描述 它 的 功能 。 你 是 否 记 得 在 第 16 章 中 ， 我 们 想 要 Passer Rating ys 


数 将 大 部 分 时 间 花 费 在 了 Game 数 据 库 的 构建 上 面 。 


- Top Functions 


调用 树 初始 的 显示 告诉 我 们 main 函 数 占用 了 App100% 的 时 间 。 之 后 我 们 至 看 main 阔 数 的 调用 ， 看 看 它们 化 费 了 多 久 的 时 


间 ， 然 后 顺 看 标的 内 容 一 层 一 层 地 加 下 至 看 。 
之 后 我 们 又 倒转 了 调用 树 ， 它 会 告诉 我 们 代价 最 高 昂 的 消 数 是 什么 ， 但 是 不 关心 它 是 如 何 调 用 的 。 我 们 需要 查看 整个 调用 
树 ， 才 能 找到 我 们 想 要 的 函数 。 


最 后 ， 我 们 勾 选 了 Hide System Libraries， 这 个 选项 会 截断 我 们 目 己 的 函数 树 。 现 在 ,我 们 能 看 到 我 们 目 己 最 耗 时 的 通 
数 ， 它 们 按照 运行 时 示 时 的 长 短 排序 一 一 这 个 时 长 包含 我 们 的 立 数 中 的 系统 销 数 调用 的 时 长 。 这 个 时 间 也 是 我 们 从 这 个 技术 中 
获得 的 最 有 价值 的 信息 。 


~ 


Top Functions 完 成 了 相同 的 工作 ， 而 不 用 在 调用 树 中 排除 任何 函数 。Detail 区 域 中 的 Call Tree 列表 显示 了 App 调 用 的 每 个 
函数 ， 还 有 花费 在 各 个 函数 中 的 总 时 间 。 排 在 第 一 位 的 肯定 是 main 函 数 ， 它 的 运行 时 长 肯定 占据 了 应 用 程序 100% 的 时 间 (Self 
询 仍 然 会 显示 执行 国 数 目 己 的 代码 的 总 时 间 ) 。 





假设 main 阔 数 调 用 了 functionA 和 functionB; 表 中 的 下 一 行 可 能 是 functionA 占 用 了 80% 的 时 间 一 -一 不 要 管 这 个 时 间 已 经 
在 main 中 计算 过 了 。 再 下 一 行 可 能 是 functionC， 它 调用 了 functonA， 这 个 函数 消耗 了 50% 的 时 间 ， 另 外 一 个 functionB 可 能 
占用 了 20% 的 时 间 。 


有 了 这 样 一 个 详细 的 列表 ， 你 束 可 以 采取 更 成 熟 的 策略 来 优化 应 用 程序 一 一 优化 的 不 是 指令 的 运行 速度 ， 而 是 指令 的 运行 
算法 。Top-function 分 析 为 你 提供 了 全 部 调用 模式 ， 其 中 包含 在 Cocoa 中 循环 调用 你 的 代码 。 


» E Extended Detail 查 看 器 中 的 栈 追 踪 也 反映 了 这 些 过 滤器 中 的 设置 。 


你 也 可 以 添加 调用 树 的 限制 ， 比 如 最 大 或 者 最 小 调用 次 数 。 这 个 方法 是 可 以 用 来 减少 (或 者 关注 ) 不 常见 的 调用 。 另 外 一 个 
限制 可 能 (比如 在 Time Profiler instrument) 通过 运行 过 程 中 花费 的 时 间 总 量 (最 小 、 最 大 或 者 两 者 都 有 ) 过 滤 调 用 树 。 


还 有 一 个 特性 对 你 会 有 很 大 帮助 ， 但 是 却 很 容易 遗漏 : Detail 跳 转 栏 最 左边 有 一 个 看 起 来 像 标 签 的 控件 ， 用 来 标识 选中 的 
instrument。 通 常 它 用 来 显示 信息 ， 但 是 实际 上 它 是 一 个 弹出 菜单 。 可 以 将 它 作 为 另外 一 种 选择 Detail 视 图 中 显示 的 
instrument 记 录 的 方法 ， 但 是 在 顶部 是 另外 一 个 条 目 Trace Highlights。 很 多 instruments (尤其 是 Activity Monitor) 都 能 将 
它 的 数据 泻 染 成 柱状 图 或 者 饼 状 图 ， 这 些 图 形 按照 进程 、 绪 程 、 事 件 类 型 或 者 共享 的 资源 分 开 显 示 。 当 你 选择 了 高 亮 视图 之 
ja, Detail area 束 会 显示 可 用 的 图 表 。 


Extended Details 


Extended Detail 区 域 的 第 三 个 选项 卡 的 名 称 是 Extended Detail。 当 你 在 带 有 栈 信息 的 Detail 区 域 中 选中 一 项 的 时 候 ， 它 通 
常 包 含 了 一 个 栈 记 录 。 当 选中 的 条 目 是 调用 树 的 一 部 分 的 时 候 ，Extended Detail 区 域 将 会 显示 heaviest 栈 ， 这 个 栈 中 占据 了 
instrument 姐 路 的 大 部 分 内 容 。 右 上 侧 还 有 一 个 Hide system calls in the stack trace 按 钮 ， 它 能 截断 你 自己 的 代码 和 调用 者 及 
被 调用 者 。 


在 调用 栈 中 选择 一 帧 束 能 在 调用 树 大 纲 中 高 亮 显示 对 应 的 调用 。 在 一 帧 上 双击 就 会 在 Detail 域 中 显示 对 应 的 源 代码 ， 其 中 还 
包含 “ 击 中 ”这 个 阔 数 的 横幅 ， 以 及 调用 这 尝 冰 数 的 比例 。 


吕 注意 当 你 双击 一 个 栈 帧 在 Detail 区 域 中 查看 源 代 码 的 时 候 ，Extended Detail 区 域 就 会 显示 生成 这 一 帧 的 对 应 函数 调用 的 
注释 。Detail 区 域 中 的 跳 转 栏 为 列表 添加 了 一 个 segment (Call Trees 一 Call Tree—[SimpleCSVFile run:error]) 。 单 击 之 前 的 


segment (Call Tree) ， 你 可 以 回 到 Detail 区 域 中 的 调用 树 和 Extended Detail 区 域 中 的 堆栈 记录 。 


26.3.5 Æ 


Instruments 通 过 在 模板 中 初始 化 或 者 从 Library 窗 口中 拖 入 一 个 instrument 的 方法 来 初始 化 Instruments 追 际 文 档 。 
库 面板 (Window Library, ŚL, 或 者 使 用 工具 栏 中 的 + 按钮 ) 列 出 了 所 有 已 知 的 instruments。 


最 开始 ， 它 是 Apple 提 供 的 追踪 工具 的 指令 集 ， 但 是 你 也 可 以 添加 自己 的 追踪 记录 。 这 个 面板 列 出 了 全 部 已 知 的 
instruments。 选 择 其 中 的 一 个 instr ument 列 表 下 面 的 面板 中 残 会 显示 对 应 的 描述 ， 见 图 26.4。 有 一 些 描述 包含 一 个 (? ) 按 
钮 ， 单 击 这 个 按钮 ， 就 会 将 你 市 到 Xcode Documentation 浏 览 器 中 Instruments 帮 助手 册 的 根 节点 。 


f 请 Library 


| | File System 





File Locks - Observes advisory file 
locking via the flock API. 





File Attributes - Observes changes to file 
atiributes such as owner, group, and 
mode, 





File Activity - Records file open, close, 
and stat operations. 





Directory 7/0 - Monitore directory activity, 


| | such as links, directory creation, moves, 
—_— 了 

ete. 

LO Activity 





Records system VO events such as reads, writes, 
opens, closes, links, Syncs, etc.. 
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图 26.4 Libraty 面 板 主 要 包含 一 个 可 用 的 instrument 的 滑动 列表 。 所 选 的 instrument 的 相应 描述 在 面板 下 面 。 在 弹出 菜单 中 选择 一 个 
范围 将 会 根据 任务 缩小 列表 范围 ， 底 部 的 搜索 栏 允许 你 根据 名 称 或 者 描述 找到 对 应 的 instrument 


Library 面 板 将 instrument 按 组 分 类 ; 一 开始 它们 都 处 于 隐藏 状态 ， 如 果 在 面板 左下 角 的 Action (齿轮 ) 弹出 窗口 中 选择 
Show Group Banners， 就 能 看 到 它们 。Action 菜 单 也 允许 你 创建 自己 的 组 一 一 将 一 个 instrument 拖 到 你 创建 的 组 就 完成 了 添 
加 操作 ; 也 可 以 只 分 组 ， 它 会 根据 你 选择 的 条 件 过 滤 库 。 面 板 硕 部 的 弹出 窗口 能 通过 分 组 来 缩小 列表 汽 围 ， 底 部 的 搜索 栏 允许 你 
按照 名 称 和 摘 述 过 滤 列 表 。 


PTS ”注意 分 组 弹出 框 下 面 的 拆 分 视图 ， 将 它 向 下 拖 动 ， 弹 出 窗口 的 内 容 就 会 被 包含 各 个 部 分 的 表 替 换 。 


26.4 追踪 
现在 我 们 开始 天 注 作 为 文档 的 退 踪 文档， 如何 从 中 获得 数据 ， 如 何 保 存 数 据 。 
26.4.1 记录 


Instrument 中 有 多 种 方法 可 以 启动 记录 操作 。 


见 的 方法 就是 创建 一 个 妃 踪 记录 文档 ， 然 后 单 击 工具 栏 中 的 Record 按 钮 。 当 记录 开始 后 ， 目 标 应 用 程序 就 会 显示 
在 最 前 面 ， 然 后 你 开始 执行 测试 ， 测 试 完 毕 切 换 回 Instruments， 再 单 击 相同 的 按钮 ， 不 过 现在 这 个 按钮 的 标签 是 Stop。 


当 你 首次 将 包含 User Interface instrument ( 仪 适 用 于 Mac 目 标 ) 的 数据 录入 文档 中 时 ，instrument 将 会 捕捉 到 你 与 目标 
App 所 有 的 交互 操作 ， 并 将 这 些 操作 录入 事件 列表 中 ， 比 如 按键 操作 、 鼠 标 移 动 、 单 击 操作 。Record Settings 查 看 器 的 Action 
弹出 窗口 允许 你 像 之 前 一 样 运行 Record Ul 事 件 ， 或 者 Drive 它 们 ， 在 下 一 次 运行 的 时 候 ， 重 复 执 行 相同 的 操作 。 


E iOS úh Automation instrument 为 你 提供 了 同样 的 功能 。 将 这 个 instrument 拖 到 Track 区 域 ， 然 后 附加 一 个 用 于 驱动 应 
用 程序 的 JavaSctipt 脚 本 。 当 Track 开始 运行 的 时 候 ，Automation 就 会 执行 提前 准备 好 的 UI 操 作 ， 其 他 instrument 也 会 开始 执行 记 
录 ， 这 样 你 就 能 直接 比 对 两 次 运行 的 结果 。 在 Documentation 浏 览 器 中 搜索 UI Automation JavaScript Reference 查看 详情 


第 二 种 记录 方法 是 使 用 组 合 键 。 为 了 设置 组 合 键 ， 我 们 需要 打开 System Preference 中 的 Keyboard 面 板 ， 选 择 Shortcut 选 
项 ， 在 Services 下 找到 Developer 组 。 这 个 组 包含 大 量 分 析 Keyboard 面 板 ， 选 择 Shortcuts 选 项 卡 ， 然 后 在 Services 下 面 查找 
Development 组 ， 这 个 组 中 包含 了 一 系列 的 分 析 行 为 ， 比 如 收集 应 用 程序 在 鼠标 光标 下 的 时 间 分 析 。 其 中 有 一 个 选项 是 Toggle 
Instruments Recording。 单 击 表 中 这 一 行 的 add shortcut 按 钮 就 能 设置 组 合 键 。 
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菜单 里 。Instrument 相 关 的 命令 都 会 带 有 相应 的 组 合 键 。 如 果 没 有 组 合 键 ， 那 么 可 能 是 因为 你 运行 的 应 用 程序 自身 占用 了 这 个 组 
合 键 。 


Instruments 在 自己 的 Preference 窗 口 下 的 General 选 项 卡 中 为 你 提供 了 一 个 System Preference 窗 口 的 快捷 键 : Open 
Keyboard Shortcut Preferences 按 钮 。 


设置 了 Toggle Instruments Recording 组 合 键 集合 后 ， 再 设置 你 想 要 记录 的 App 扔 踩 记 录 文 档 一 一 但 是 不 要 运行 它 。 运 行 
这 个 App， 然 后 按 下 你 选择 的 组 合 键 ，Instrument 惑 会 开始 记录 。 再 次 按 下 ， 残 会 停止 记录 。 


如 果 你 为 其 他 Instrument 服 务 提 供 了 一 个 组 合 键 ， 比 如 Allocations&Leaks， 那 么 Instruments 就 会 为 前 痕 应 用 程序 创建 一 
个 新 的 奶 蹊 记录 文档 并 记录 它 的 内 存活 动 。 与 之 相同 的 还 有 File Activty, System Trace 以 及 其 他 共享 Instruments 模 板 名 的 服 


务 。 


要 特别 注意 3 个 Time Profile 命 令 ， 分别 是 将 当前 的 活动 应 用 程序 作为 目标 ， 在 姐 标 指针 下 有 一 个 应 用 程序 窗口 的 后 从 应 用 
程序 或 者 整个 系统 。 将 鼠标 指向 目标 窗口 之 一 的 选项 允许 你 同步 追 路 多 个 应 用 程序 ， 而 不 用 打 乱 它们 在 窗口 中 的 顺序 。 


显示 不 间断 的 追踪 信息 ， 尤 其 是 多 个 应 用 程序 的 追踪 信息 ， 会 让 系统 背负 沉重 的 性 能 负担 ; 我 会 介绍 详细 情况 。 如 果 你 使 用 
热 键 记录 多 个 应 用 程序 的 追踪 信息 ， 这 会 变 为 特殊 问题 。 如 果 勾 选 Preferences 窗 口 下 General 选 项 卡 中 的 Always use deferred 
mode， 你 就 能 保证 热 键 追 踪 变 得 相当 轻 量 级 。 


第 三 种 记录 的 方法 是 通过 Mini Instruments 窗 口 。 选 择 View 一 Mini Instruments 就 能 隐藏 所 有 的 Instruments 窗 口 ， 然 后 
显示 一 个 浮动 窗口 ， 其 中 列 出 了 所 有 打开 的 退路 记录 文档 ， 见 图 26.5。 
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Whole System. tracas 





图 26.5 Mini Instruments $a Ao, CAH TANAR, FARA — AeA Rki. MALE HARA 


这 个 列表 


当 你 切换 Mini 模 式 时 ， 这 个 窗口 列 出 了 所 有 打开 的 奶 踩 记录 文档 ， 按 住 上 下 和 荫 头 残 能 滚动 这 个 列表 。 每 个 条 目的 左边 是 用 
Kaa) (AKAT) KESE (ARE) 的 记录 按钮 ， 还 有 一 个 时 钟 用 来 显示 记录 持续 了 多 长 时 间 。 停 止 和 重 局 动 一 个 记录 会 
在 文档 中 添加 一 条 新 的 记录 信息 。 


关闭 Mini Instruments 窗 口 就 会 激活 Instruments， 然 后 恢复 记录 窗口 。 


正如 热 键 一 样 ，Mini Instruments 的 优势 在 于 在 应 用 程序 运行 期 间 (如 果 你 想 要 记录 用 于 循环 运行 的 User Interface 追 路 记 
R) 它 能 方便 地 启动 记录 。 它 消除 了 更 新 记录 显示 的 开销 。 


我 已 经 提 到 退路 会 话 会 给 计算 机 带 来 性 能 负担 。 当 运行 一 个 奶 踪 会 话 的 时 候 ，Instr uments 会 分 析 它 收集 的 数据 、 构 建 资 料 
和 表 。 同 时 它 需要 参考 之 前 的 数据 [比如 匹配 内 存 事件 来 阻止 或 者 更 新 当前 存在 以 及 消失 的 事件 (living-versus-transient) 数 
量 ] ， 以 保证 分 析 的 实时 性 。 


现在 计算 机 的 运行 速度 已 经 相当 快 ， 但 是 追踪 进程 会 从 目标 应 用 程序 (因此 难以 通过 真实 世界 的 条 件 来 衡量 App) PA 
源 ， 并 会 强制 要 求 Instruments 跳 过 数据 点 。 通 过 追踪 停止 后 延迟 分 析 数 据 可 以 阻止 这 种 问题 的 发 生 。File 一 Record 
Optionshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (CER) 能 设置 追踪 的 参数 ， 比 如 等 应 用 程序 
局 动 后 ， 延 迟 数秒 再 局 动 数据 收集 ， 或 者 将 数据 收集 限定 在 固定 的 时 间 周 期 内 。 你 感 兴 趣 的 选项 是 Deferred Mode 复 选 框 。 当 
选中 这 个 选项 的 时 候 ，Instruments 将 会 中 断 追 路 窗口 ， 直 到 运行 停止 。 一 旦 程序 运行 结束 ，Instruments 才 开始 分 析 数 据 ， 箭 


后 束 会 看 到 追 路 记录 ， 见 图 26.6。 


start Delay: 
ea Time Limit: 


Window Limit: 


At least one instrument needs to run in deferred mode. 


Cancel 





图 26.6 File—>Record Options 这 个 命令 会 显示 一 个 界面 ， 在 这 个 界面 中 可 以 显示 Instrtuments 追 踪 会 话 的 范围 ， 并 能 通过 追踪 完毕 


显 
后 延 衣 分 析 数 据 改 善 追 踪 的 效率 。 在 这 个 例子 中 ， 追 踪 文 档 中 的 instrument 需 要 延 迟 分析 


26.4.2 ” 保 仔 和 重新 打开 


和 其 他 任意 Macintosh 文 档 一 样 ， 可 以 保存 一 个 姐 路 记录 文档 。 这 个 文档 将 会 包含 instruments 和 它 收集 的 所 有 数据 。 其 中 
有 大 量 数 据 一 一 完整 的 栈 追 踪 信 息 可 能 仪 仪 占 一 小 部 分 一 一 所 以 一 个 追踪 文档 可 能 会 非常 大 。 上 百 兆 的 文档 也 很 常见 ， 追 踪 文 
档 通 常 都 会 使 用 ZIP 格 式 压 缩 。 


另外 一 种 保存 文档 的 方法 束 是 作为 模板 保存 。 可 能 你 需要 一 个 Apple 默 认 模 板 中 没有 包含 的 统一 instruments 布 局 。 你 可 以 
很 轻松 地 创建 属于 你 自己 的 模板 ， 它 也 会 显示 在 创建 新 追踪 记录 文档 的 模板 界面 中 。 配 置 一 个 你 想 要 的 文档 ， 然 后 选择 


File 一 Save as Template..., 


保存 文件 的 界面 还 是 那个 标准 的 界面 ， 注 意 Instr uments 查 找 模板 的 目录 是 : ~/Library/Application 
Support/Instruments/Templates。 文 件 名 束 是 模板 选择 界面 的 标签 名 。 界 面 的 左下 角 有 一 个 区 域 ， 你 可 以 将 包含 自 定义 模板 
的 列表 中 的 图 标 拖 到 这 里 。 比 如 ， 如 果 你 的 模板 用 于 测试 应 用 程序 ， 那 么 你 可 能 想 要 将 这 个 应 用 程序 图 标 文件 拖 到 这 里 。 在 这 个 
区 域 上 按 住 鼠标 ， 融 会 显示 一 个 包含 Apple 提 供 的 图 标的 弹出 菜单 。 这 个 面板 提供 了 一 个 文本 区 域 ， 用 来 显示 模板 选择 界面 中 的 
摘 述 文本 。 

与 文档 对 应 的 insttuments 和 它们 的 配置 都 会 保存 在 模板 中 。 


. 模板 将 会 包含 你 设置 的 特定 的 instrument 目 标 。 


如 果 你 包含 预先 录制 好 的 User Intefface 追 踪 记 录 ， 那 么 它 的 内 容 也 会 被 保存 。 这 就 是 说 ， 你 可 以 创建 一 个 新 的 追踪 文档 ， 


然后 选中 这 个 模板 ， 就 可 以 生成 统一 的 测试 文档 。 跟 你 想 的 一 样 ， 在 Finder 中 双击 跟踪 文档 就 能 重新 打开 一 个 文档 ， 或 者 选择 
File 一 Open 命 令 。 所 有 的 数据 就 是 当时 保存 它 的 时 候 的 数据 。 单 击 Record 按 钮 会 在 文档 中 添加 一 个 新 的 运行 。 


26.4.3 ”不 启动 Instrumentic 录 


在 不 局 动 Instruments 的 情况 下 ， 有 3 种 方法 运行 奶 蹊 记录 。 借 助 instruments 命 令 行 工具 ， 你 可 以 选择 目标 应 用 程序 ， 然 后 
再 选择 一 个 模板 或 者 已 经 存在 的 追踪 记录 文档 来 捕获 追踪 数据 。DTPerformanceSession 框 架 允 许 你 从 源 代码 中 初始 化 追踪 记录 
而 不 用 借助 Instruments app 模 板 和 文档 基础 设置 。 同 时 iprofiler 也 在 命令 行 中 提供 了 相同 的 轻 量 级 的 分 析 。 详 见 man 


instruments, man iprofiler 以 及 DTPerformanceSession 文 档 。 


26.5 Instruments 
Instruments 应 用 程序 中 有 44 个 instrument， 还 包含 你 自己 创建 的 instruments。Library 面 板 ，Window 一 Library 列 出 了 所 
有 的 instr uments。 这 一 部 分 的 列表 按照 Library 的 形式 组 织 ， 其 中 还 市 有 我 之 前 给 你 展示 的 内 容 。 


部 分 instruments 无 法 通过 Library 中 的 三 言 两 语 的 描述 概括 清楚 ， 有 很 多 内 容 需 要 用 展示 的 数据 来 解释 。 有 列表 中 的 
instrument 很 少 标注 面向 的 平台 。 在 某 些 情况 下 ， 我 会 补充 上 这 些 信 息 ; 在 其 他 情况 下 ， 我 跟 你 一 样 都 需要 猜测 ， 如 果 在 不 合 
适 的 平台 上 运行 ， 这 个 instrument 就 会 衣 演 ， 所 以 就 知道 结果 了 。 


26.5.1 Behavior 


Sudden Termination ( 仅 Mac) 一 一 审查 直接 主动 终止 那些 应 该 被 安全 结束 的 Apps 的 OS X 特 性 。 这 个 instrument 会 标记 
当 你 向 系统 请 求 突然 终止 应 用 程序 是 否 可 行 的 信号 时 ， 所 有 的 文件 系统 的 活动 。 如 果 此 时 你 正在 读 取 或 者 写 入 文件 ， 那 么 在 没有 
通知 的 情况 下 就 结束 应 用 程序 可 能 不 是 一 个 好 做 法 。 


26.5.2 Core Data 





在 Core Data 的 每 次 保存 操作 中 ， 记 录 对 象 的 线程 ID， 栈 追踪 记录 以 及 保存 所 花费 的 时 间 。 


- Core Data Saves 





- Core Data Fetches 捕获 Core Data 下 面 每 次 抓 取 操作 发 生 的 线程 ID 和 栈 追 踪 人 信息， 及 抓 取 到 的 对 象 数量 ， 以 及 完成 抓 取 


操作 所 花费 的 时 间 。 





- Core Data Faults Core Data 对 于 内 存 和 载 入 内 存 的 时 间 来 说 ， 它 都 非常 昂贵 。 通 各 一 个 NSManagedObject 或 者 对 多 的 关系 


都 会 被 认为 是 一 个 失误 ， 它 是 一 种 IOU (借条 ) ， 当 你 在 对 象 中 引用 数据 的 时 候 就 要 偿还 这 部 分 代价 。 


这 个 Instrument 会 捕获 每 次 击 中 (payoff) 对 象 或 者 天 系 的 错误 。 它 能 显示 出 线程 ID 和 错误 栈 的 深度 ， 以 及 满足 对 象 和 关 
系 错误 所 花费 的 时 长 。 





* Core Data Cache Misses 一 个 有 问题 的 Cote Data 对 象 可 能 已 经 存在 于 内 存 之 中 ，NSPetrsistehtStoteCottdinatot 的 缓存 可 能 
持 有 这 个 对 象 。 然 而 ， 如 果 你 想 使 用 缓存 中 并 不 存在 的 对 象 (“ 缓 存 未 命中 ) ， 那么 你 需要 执行 额外 的 操作 ， 因 为 这 个 对 象 必 


须要 从 数据 库 中 直接 读 取 。 当 在 不 影响 用 户 体 验 的 情况 下 ， 你 可 能 会 通过 提前 载 入 对 象 的 方法 最 小 化 读 取 缓存 失败 带 来 的 影响 。 


这 个 instrument 显 示 了 缓 仓 未 命中 友 生 的 位 置 。 它 记录 了 线程 ID 和 每 次 未 命中 时 候 的 标 退 踩 信 息 ， 以 及 对 于 对 象 和 天 系 来 


说 ， 为 了 弥补 这 次 缓 仔 未 合 中 的 情况 所 人 花费 的 时 间 。 


26.5.3 Dispatch 


Dispatch ({WMac) 一 一 记录 Grand Central Dispatch 事 件 ， 队 列 的 状态 以 及 分 发 任务 的 时 间 。 


26.5.4 Filesystem 


- Directory I/O 〈 仅 Mac ) 





记录 影响 文件 来 的 每 个 系统 调用 事件 ， 比 如 创建 、 移 动 、 挂 载 、 印 载 、 重 命名 以 及 链接 。 记 
录 的 数据 包括 线程 ID， 堆 栈 追 踪 记 录 ， 调用， 影响 的 文件 夹 路 径 以 及 目标 路 径 。 


File Activity 〈 仅 Mac ) 





记录 了 open、close、fstat、open$UNIX2003 和 close$UNIX 2003 的 每 个 调用 。 这 个 instrument 捕 获 
了 线程 ID、 堆 栈 追 踪 记 录 、 文 件 描 述 符 和 文件 路 径 。 


E 
记录 的 数据 包含 线程 ID、 堆 栈 追 踪 记 录 、 被 调用 的 函数 、 文 件 描 述 符 、 组 和 用 户 IDs、 模 式 标识 以 及 受 影 响 的 文件 路 径 。 


- File Locks 〈 仅 Mac) 一 一 它 会 记录 每 次 对 flock 系 统 函 数 的 调用 ， 记 录 的 信息 有 线程 ID、 堆 栈 追 踪 记 录 、 函 数 、 选 项 标识 以 
及 每 次 对 flock 系 统 调 用 的 路 径 。 


-1/O Activity (UOS) 一 一 将 这 个 分 类 中 所 有 仅 限 于 Mac 使 用 的 instrument 的 功能 都 集成 在 这 一 个 综合 性 的 insttrument 中 。 F 
认 情 况 下 ， 它 仅 收集 每 次 调用 持续 的 时 间 。 单 击 Configure 按 钮 就 能 看 到 其 他 可 用 的 选项 。 


26.5.5 Graphics 


- Core Animation (4210S ) 收集 OpenGL 当 前 状态 的 统计 人 信息 $ 包括 调 用 者 等 待 的 时 间 、 外 观 ,和 绞 理 的 数量 以 及 显存 的 
占用 量 ， 因 为 它 关 系 到 你 的 App 对 高 等 级 Core Animation 框 架 的 使 用 。 


- GPU Driver (Mac 或 者 OS) 一 一 收集 与 Core Animation instrument 相 同 的 统计 信息 ， 它 处 于 OpenGL/OpenGL ES 的 低 等 级 部 
分 。 有 两 个 instruments 具 有 相同 的 名 字 ， 将 其 中 一 个 拖 动 到 追踪 文档 中 ; 如 果 猜 错 了 ，track 右 下 角 会 出 现 一 个 黄色 的 警告 三 角 ， 
然后 你 就 可 以 党 试 另 外 一 个 。 


- OpenGL ES Analyzer ( 仅 1OS) 


划分 的 问题 列表 和 如 何 避 免 它们 的 建议 。 





分 析 应 用 程序 中 OpenGL ES 的 使 用 情况 ， 标 记 停止 错误 及 其 他 错误 ， 列 出 一 个 按 等 级 


26.5.6 Input/Output 


- Reads/Writes 





文件 描述 符 的 读 写 操作 。 每 个 事件 包含 线程 ID， 被 调用 的 函数 名 称 、 堆 栈 跟踪 记录 、 文 件 描 述 符 以 及 文 
件 路 径 ， 还 有 读 取 和 写 入 的 数据 量 。 


26.5.7 Master Tracks 


User Interface ( 仅 Mac) ， 当 第 一 次 运行 的 时 候 ， 在 你 使 用 OS X 应 用 程序 的 时 候 ， 它 会 记录 鼠标 和 键盘 事件 。 它 会 让 你 授 
权 Insttument 控 制 你 的 应 用 程序 ， 在 System Preferences application 一 Secutity&Ptivacy 一 Privacy 一 Accessibility 中 可 以 完成 授权 。 之 
后 ， 再 次 运行 追踪 记录 播放 UI 事 件 ， 这 样 在 你 做 出 调整 的 时 候 就 会 有 一 个 统一 的 基准 。 


- Cocoa Layout ( 仅 Mac) 记录 了 对 NSLayoutConsttaint 对 象 的 任何 更 改 ， 无 论 是 在 目标 应 用 程序 中 还 是 在 系统 的 某 个 地 方 。 从 
收集 的 数据 中 获得 你 想 要 的 信息 并 不 太 轻 松 ， 最 好 的 方法 是 记录 你 感 兴 趣 的 视图 ， 然 后 在 搜索 栏 中 输入 它 的 地 址 。 


我 的 Instruments 将 Cocoa Layout 放 到 了 Custom Instruments 分 类 下 ， 而 不 是 Master Track 下 ， 但 是 对 我 来 说 ， 将 它 放 
到 User Interface 分 类 下 会 更 加 合理 。 


26.5.8 Memory 


- Allocations (iDS 和 Mac) 一 -一 收集 追踪 过 程 中 每 个 内 存 分 配 操作 的 完整 历史 记录 。 每 个 事件 都 会 用 区 块 地 址 和 当前 的 堆栈 
追踪 记录 信息 作为 标签 。 配 置 选项 能 让 你 跟踪 Cocoa 引 用 计数 事件 并 创建 “僵尸 (zombie) ” 对象。 在 第 16 章 中 你 已 经 学 习 了 如 
何 使 用 。 


- Leaks (iOS 和 Mac) 一 一 为 了 检测 对 象 分 配 后 又 丢失 的 问题 ， 也 就 是 内 存 泄露 ， 它 记录 了 应 用 程序 的 分 配 和 回收 操作 。 
Leaks 并 不 是 简单 地 依赖 分 配 和 回收 操作 的 平衡 。 它 会 周期 性 地 交换 程序 的 堆栈 ， 检 测 没 有 被 活动 内 存 引 用 的 区 块 。 如 果 
Allocations insttument 被 用 来 检测 僵尸 对 象 ， 那 么 Leaks 就 不 会 再 记录 ， 因 为 僵尸 对 象 不 会 被 回收 ， 它 们 都 会 产生 内 存 泄露 。 更 多 


详细 内 容 ， 请 参见 第 16 章 。 





- Shared Memory (4%Mac) 记录 共享 内 存 打 开 或 者 分 离 的 事件 。 这 个 事件 包含 调用 的 线程 ID 和 可 执行 文件 、 挫 栈 信息 、 
函数 (shm open/shm_unlink) 以 及 参数 (共享 内 存 的 名 字 、 标 记 以 及 mode_t) 。 在 Detail 表 中 选择 一 个 事件 ， 然 后 将 堆栈 追踪 记 


录放 到 Extended Detail 面 板 中 。 





会 为 与 你 的 应 用 程 友 相 关联 的 虚拟 内 存 区 域 提供 快照 ， 记 录 虚 拟 内 存 每 一 块 的 大 小 以 及 它 
是 共享 还 是 私有 的 。 这 个 追踪 记录 显示 了 虚拟 内 存 的 全 部 使 用 情况 ,但 是 实际 上 记录 的 是 “ 脏 ” 记录 : VM 系统 可 以 像 系统 库 一 
样 通过 物理 RAM 上 的 一 部 分 跨 应 用 程序 共享 内 容 ， 那些 没 有 被 应 用 程序 写 入 的 内 存 称 为 “干净 的 ”内 存 一 一 系统 能 够 假装 这 块 

内 存 为 零 所 以 不 用 消耗 实际 的 RAM。 一 看 应 用 程序 开始 写 入 内 存 ， 这 些 地 址 就 会 变 为 “ 脏 ” 地 址 ， 同 时 它们 必须 消耗 之 前 的 物 

理 内 存 。 


不 要 在 iOS Simulator 中 使 用 VM Tracker。 在 虚拟 内 存 这 一 级 别 ， 模 拟 器 是 一 个 Mac 应 用 程序 ， 它 与 iOS 设 备 中 的 内 存 使 用 
没有 什么 天 系 。 


默认 情况 下 ， 你 需要 单 击 Options 视 图 中 的 Snapshot Now 按 钮 来 收集 堆 数据 。 如 果 你 想 要 周期 性 的 收集 数据 ， 那 么 需要 勾 
选 Automatic Snapshotting, 


26.5.9 ”系统 


有 两 种 instruments 处 于 系统 类 别 : 记录 目标 机 器 状态 的 instruments 和 读 取 iOS 设 备 未 与 Mac 相 连 时 记录 的 日 志 的 


instruments。 我 将 分 别 介绍 这 些 instruments。 


- Activity Monitor (iOS 和 Mac) 一 一 模拟 了 UNIX 上 面 的 top 命 令 ， 它 只 关注 于 一 个 进程 。 这 个 instrument 很 复杂 难以 在 这 里 解 
释 清 楚 ， 但 是 如 果 查 看 它 的 配置 查看 器 ， 它 的 特性 很 容易 理解 。 它 收集 了 一 个 运行 的 进程 中 的 31 项 总 结 性 统计 信息 ， 包 括 线程 数 


量 、 物 理 内 存 使 用 情况 、 虚 拟 内 存活 动 、 网 络 使 用 ， 硬 盘 操 作 以 及 CPU 负载 比例 。 记 住 ， 同 时 可 以 运行 多 个 Activity Monitor 
insttument， 监 视 不 同 的 应 用 程序 或 者 系统 。 


- Connections 〈 仅 iDS) 一 一 实时 度量 iOS 设 备 或 者 其 上 运行 的 任意 进程 中 所 有 的 IP 网 络 活动 。 


- Counters 和 Event Profiler ( 仅 Mac) 一 一 利用 构建 在 每 个 CPU 内 核 中 的 硬件 诊断 计数 器 追踪 CPU 和 低 等 级 的 系统 事件 。 它 的 


数据 相当 基础 ， 但 是 如 果 你 想 要 逐条 指令 优化 代码 ， 比 如 优化 低 效 率 的 分 支 ， 这 些 instruments 特 别 适 合 。 


Window 一 Manage Flagshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (T&T) 控制 Counters 中 哪个 标签 用 于 触发 计 
数 操作 。 当 Counters 运 行 的 时 候 ， 将 性 能 影响 控制 在 预期 范围 内 。 对 于 Event Profiler 来 说 ，Window 一 Manage PM 
Eventshttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... (P) 设置 了 用 来 审计 的 标识 。 


- Process (人 和 仅 Mac) 


件 的 可 执行 路 径 。 





记录 了 进程 中 的 线程 ID、 堆 栈 追 踪 信息 、 进 程 ID、 退 出 状态 和 每 个 开始 (execve) 和 结束 (exit) 事 


- Sampler (iOS 和 Mac) 一 一 在 固定 的 间隔 (默认 是 1 秒 , 但 是 你 可 以 在 查看 器 中 设置 这 个 值 ) 内 周期 性 的 对 目标 应 用 程序 抽 
样 ， 并 每 次 都 记录 堆栈 信息 。 这 个 instrument 已 经 被 Time Profiler pA, 但 有 些 情况 除外 : 比如 测量 图 形 性 能 的 时 候 ， 对 于 最 小 化 
CPU 采集 其 他 度量 数据 的 影响 方面 有 很 重要 的 作用 。 


- Spin Monitor (Mac) 一 一 专注 于 一 个 或 者 所 有 OS X 应 用 程序 ， 当 它们 没有 响应 时 记录 它们 的 堆栈 追踪 记录 。 “无 响 
应 ”的 应 用 程序 指 的 是 : 它 花费 了 大 量 的 时 间 却 没有 收集 到 用 户 界 面 时 间 。 当 出 现 一 个 开始 旋转 的 多 彩 “ 皮 球 鼠标 时 ， 这 个 应 
用 程序 就 变 得 无 法 响应 。 这 是 应 用 程序 的 严重 问题 ， 但 是 你 通常 无 法 重 现 这 个 转圈 的 情况 。Spin Monitor KRA IF ARERR, 
占用 很 少 的 资源 ， 直 到 出 现 转圈 的 情况 才 会 被 激活 。 


- Time Profiler (iOS 和 Mac) 一 一 在 固定 的 时 间 间 隔 (默认 是 1 秒 ， 不 过 你 可 以 在 查看 器 中 设置 这 个 值 ) 内 周期 性 的 对 目标 应 
用 程序 采样 ， 并 记录 各 个 时 刻 的 堆栈 追踪 信息 。 然 后 你 就 会 得 到 一 幅 统 计 图 表 ， 知 道 应 用 程序 哪 一 部 分 花费 的 时 间 最 多 。 这 个 是 
6 章 


一 个 非常 重要 的 工具 ， 当 有 人 说 分 析 一 款 应 用 程序 的 时 候 ， 指 的 基本 就 是 它 。 第 16 章 中 阐述 了 Time Profiler 的 使 用 。 


当 Time Profiler 处 于 人 姐 路 记录 文档 中 的 时 候 ， 一 个 工具 栏 丈 会 添加 到 Trace area， 使 用 它 能 优化 分 析 行 为 : 左边 的 
segment 控 件 提供 了 一 个 整体 的 追踪 (中 ) ， 或 者 它 可 以 按照 CPU 内 核 (A) 或 者 线程 (4) 划分 。 一 系列 弹出 菜单 允许 通过 
处 理 器 内 核 、 进 程 和 线程 限制 追踪 记录 信息 ; 同时 它们 能 让 你 把 用 户 或 者 内 核 负载 用 不 同 的 颜色 标记 。 工 具 栏 右 侧 是 一 个 用 来 显 
示 图 标 中 所 用 颜色 的 弹出 菜单 。 


» tE = Xcode 5 中 的 很 多 instrument 都 被 移 除 了 一 一 被 移 除 的 insttrument 名 中 都 带 有 Monitot。 它 们 并 不 是 真正 的 独一无二 的 
instrument， 仅 仅 是 开导 了 某 些 统计 信息 的 Activity Monitor。 如 果 你 还 想念 这 些 instrument， 那 么 就 打开 Activity Monitor， 然 后 匀 选 


感 兴 趣 的 统计 信息 。 如 果 你 使 用 Stacked 图 形 类 型 和 Increase Deck Size 让 记录 更 高 ， 那 么 就 会 得 到 相同 的 效果 。 


26.5.10 System-iOS Energy Instruments 


Instruments Librarył§iOSRÉŒinstrumenthkE! 7 Systemi, (BRENAAS HR. Bi Mc#lnstrumentsia{Tibis 
记录 ， 因 为 只 有 当 设 备 连 接 到 Mac 上 的 时 候 才 运行 它们 无 法 达到 效果 。 当 你 指定 了 一 个 开 友 设备 ，Xcode (或 者 Instruments) 
融会 在 设备 上 安 妆 一 个 守护 进程 ， 它 能 记录 影响 电量 消耗 的 活动 。 


当 设 备 再 次 与 Instruments 连 接 的 时 候 ， 你 就 可 以 分 析 日 志 。 打 开 lnstruments， 然 后 选择 File 一 Import Energy 


Diagnostics from Device。 


默认 情况 下 ， 记 录 功 能 处 于 天 闭 状 态 ， 必 须 使 用 Settings 这 个 App 局 动 记录 功能 。 守 护 进 程 本 身 可 以 通过 setting 中 的 
Developer 面 板 天 闭 ， 未 连续 的 时 候 重 局 也 能 天 闭 这 个 进程 。 如 果 点 碗 完 全 消耗 元 毕 ， 那 么 守护 进程 融 无 法 再 重新 局 动 。 


下 面 是 分 析 日 志 使 用 的 instruments: 





- Bluetoothe、GPS 和 WiFi 当 启 动 相 应 频段 信号 的 时 候 就 会 开始 记录 。 








- CPU Activity 1X 4Ninstrument Æ Activity Monhitot 的 压缩 版 本 ， 显 示 了 整体 的 CPU 负载 情况 ， 其 中 包含 前 端 应 用 、 上 声音 和 
图 形 的 峰值 。 

- Display Brightness 这 个 insttrument 记 录 了 设备 背景 光 的 亮 / 瞳 状态 。 环 境 光 的 调整 不 在 记录 范围 之 内 。 

- Energy Usage 以 20 为 单位 的 电量 消耗 。 当 设备 插入 或 拔 出 电源 的 时 候 ， 这 个 事件 就 会 被 激活 。 








- Network Activity 按照 比特 和 包 记 录 整 体 的 网 络 使 用 情况 。 


- Sleep/Wake 记录 设备 是 否 处 于 休眠 状态 ， 以 及 睡眠 转换 状态 。 





26.5.11 线程 / 锁 


Thread State ( 仅 Mac) 一 一 使 用 一 个 区 块 表示 目标 应 用 程序 中 每 个 线程 ， 用 不 同 的 颜色 区 分 线程 在 各 个 时 刻 的 状态 一 一 
运行 、 等 待 、 挂 起 等 。 打 开 配 置 区 查看 颜色 代码 ， 见 图 26.7。 
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图 26.7 Thread States insttument 用 带 有 顾 色 的 堆 又 条 状 图 显示 进程 中 每 个 线程 的 状态 


26.5.12 记录 


Scheduling, System Calls 和 VM Operations (iOS 和 Mac) 一 一 它们 分 别 会 记录 线程 切换 时 候 的 完整 记录 ; 用 户 代码 和 
内 核 之 间 调 用 的 完整 记录 以 及 由 虚拟 内 存 系 统管 理 的 内 存 布局 。 你 能 读 取 到 代码 等 待 内 核 级 别 的 调用 处 理 完成 的 时 长 。 人 退路 记录 
有 两 种 “策略 ”用 于 显示 ， 通 过 工具 栏 左 侧 的 Segment 控 件 可 以 选择 哪些 instrument 将 会 插入 时 间 记 录 的 上 部 。 


这 些 instrument 强 制 使 用 延迟 模式 ， 它 们 会 在 时 间 线 上 插入 一 栏 来 选择 显示 的 “策略 ”: event density 条 状 图 或 者 显示 状 
态 和 标识 切换 的 时 间 线 一 一 单 击 一 个 标识 就 能 得 到 切换 类 型 、 时 间 和 追踪 记录 信息 的 描述 。 


这 一 栏 上 还 有 一 个 弹出 菜单 ， 它 能 指定 显示 特定 的 进程 和 线程 。 
26.5.13 Ul Automation 


Automation ({QiOS) 一 一 企 设备 或 模拟 器 上 执行 一 段 Javascript 脚 本 ， 测 试 IOs 应 用 程序 的 UIl。 将 其 他 instrument 添 加 到 
追踪 文档 中 可 以 重新 生成 一 个 测试 和 记录 App 性 能 的 包 。 在 Detail 区 域 的 Options 视 图 中 配置 这 个 instr ument。 最 重要 的 部 分 是 
Script 部 分 ，Add 下 拉 菜 单 允 许 你 Importhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 一 个 .js 文件 到 追踪 记录 中 ， 或 者 使 用 Create... 在 
Detail 区 域 的 编辑 器 中 创建 一 个 。 


UI 自动 化 中 有 大 量 的 类 树 : 使 用 Instruments User Guide 和 UIAutomation Reference Collection 查 看 详细 信息 。 


26.5.14 APR 


Carbon Events ({{Mac) 一 一 从 WaitNextEvent 中 返回 的 监视 器 事件 。Carbon Eventsi 记 录 了 每 次 从 WaitNextEvent 及 
子 事件 中 返回 的 一 个 事件 。 它 会 捕捉 到 线程 1D、 堆栈 奶 踪 记录 、 事 件 代码 和 用 来 描述 事件 的 一 个 字符 串 (比如 Key Down) 。 


Cocoa Event ( 仅 Mac) 一 一 记录 了 使 用 -[NSApplicaition sendEvent:] 分 上 友 的 每 个 事件 对 象 。 它 会 捕获 线程 ID、 堆 栈 退 路 
记录 、 事 件 代 码 ， 以 及 描述 事件 的 字符 串 (比如 Left Mouse Down) 。 


26.6 BX Instruments 


Instruments 中 很 多 instrument 都 包含 专门 为 任务 写 的 代码 ， 但 是 大 多 数 都 不 涉及 本 地 代码 。 它 们 由 可 编辑 的 模板 构成 : 你 
可 以 目 己 检查 这 些 instrument 一 一 这 可 能 是 得 到 instrument 做 了 什么 的 唯一 方法 一 一 同时 你 也 可 以 创建 属于 目 己 的 


Instrument。 





让 我 们 看 看 脚本 化 的 instrument 是 什么 样 的 。 在 File Activity 模 板 中 创建 一 个 追踪 记录 文档 ， 选 择 Reads/Writes 
instrument， 然 后 选择 Instrument 一 Edit′ Reads/Writes’ Instrument (或 者 简单 地 双击 instrument 的 标签 ) ， 就 会 出 现 一 个 
可 编辑 的 界面 ， 见 图 26.8。 其 中 包含 instrument 的 名 称 栏 、 种 类 、 拉 述 等 信息 ， 还 有 一 个 包含 probes 的 滩 动 列表 ，probe 是 
instrument 捕 获 的 事件 处 理 器 。 


图 26.8 中 的 System Call 域 中 显示 了 一 个 可 滚动 的 事件 列表 名 为 PWrite， 它 用 于 符号 pwrite。 调 用 pwrite 消 数 的 时 候 束 会 触 
发 这 个 事件 。 当 这 个 probe 被 触 友 的 时 候 ， 下 一 个 可 执行 的 脚本 就 会 运行 。Instruments 使 用 DTrace 内 核 工 具 ， 它 有 目 己 的 脚本 
语言 ; 比如 ， 这 个 事件 可 能 会 放 在 事件 友 生 的 probe 线 程 变 量 中 ， 这 样 pwrite-exit probe 残 能 计算 调用 的 时 间 并 记录 。 在 这 个 
例子 中 ， 脚 本 栏 为 空 。 


Reads Writes Input utout 





Description: Records reads and writes oi bytes to files. 


PWrite - syecall: : pwrite: entry 


lf the following conditions are met: 
Probe Pyrite oftype | System Call hits | owrite entry tT 


Perform the following script: 


Record the following data: 


Record in ratr menta Function | 
Hacord in Instru menta Executable = || + 
Record in Instruments arg FD Integer = || $ 
Record in Instruments Custom siringoffdpathsip | Path string = || + 
Record in Instruments ange Bytes intege | 
Record No Data seller 


Film Clasa = guerall: elinge : entry 





十 | 一 | | User Stack Trace [eg 
Cancel 
图 26.8 Reads/Writes instrument 44 Edit Instrument J f o 界面 包含 一 个 insttument 捕 获 的 可 编辑 事件 列表 。 指 定 如 何 将 条 目 记 
录 到 系统 中 的 pwtite 函 数 也 显示 在 这 里 


接 下 来 束 是 一 系列 用 来 指定 在 追 叶 图 或 者 Detail 视 图 中 保存 什么 信息 的 条 目 。 在 Reads/Writes 这 个 例子 里 ， 包 合 : 


TRAT A ro 

. 第 一 个 参数 (文件 描述 符 ) ， 它 是 标签 为 FD 的 整数 

- 标签 为 Path 的 字符 串 ， 它 由 DTtace 语 言 的 表达 式 计 算 而 来 : 它 是 一 个 文件 路 径 ， 继 承 于 可 执行 程序 中 的 文件 描述 符 。 
` 第 三 个 参数 〈 写 入 的 大 小 ) ， 它 是 一 个 标签 为 Bytes 的 整 


编辑 界面 的 底部 是 一 个 下 拉 菜 单 ， 它 控制 着 instrument 是 人 否 记录 事件 的 堆栈 跟踪 ， 以 及 栈 是 人 否 应 该 从 user、kernel 或 者 no 
space 中 读 取 。 


配置 查看 器 的 Statistics to Graph 列 表 中 包含 整数 值 记 录 ， 而 且 整 数值 记录 适 于 在 instrument 追 踪 信 息 中 显示 。 如 果 你 单 击 
instrument-configuration 弹 出 窗口 的 Configure 按 钮 ， 它 就 会 计算 可 用 plots 列 表 中 tid (线程 ID) 的 数量 。 


自 定 义 界 面 是 用 于 内 核 提供 的 DTrace 工 具 的 脚本 语言 的 前 痕 ; 只 有 内 核 级 别 的 代码 才能 检测 到 每 个 进程 中 的 事件 调用 。 
Instruments User Guide 中 的 Creating Custom Instruments 详 细 介 绍 了 如 何在 你 自己 的 instrument 中 使 用 这 些 语言 。 


为 了 制作 你 自己 的 instrument， 单 击 Instrument 一 Build New Instrument (¢6B) 命令 ， 最 前 面 的 追踪 文档 中 就 会 弹出 一 
个 instrument 编 辑 界面 ， 你 可 以 从 这 里 开始 着 手 制作 。 


浏览 https://wikis.oracle.comy/displayWDTrace/Documentation 会 让 你 变 成 一 个 DTrace 专 家 ， 它 可 能 会 让 你 找到 更 方便 ， 
或 者 更 灵活 的 方法 直接 编写 目 己 的 脚本 ， 而 不 用 通过 目 定 义 界 面 。 选 择 File 一 DTrace Script 
Exporthttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/.…. 瓯 能 将 履 盖 每 个 instrument 的 脚本 保存 到 当前 的 
文档 中 。 选 择 File 一 DTrace Data Importhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/... 能 载 入 一 个 上 自 定 义 脚本 。 你 可 以 从 包含 DTrace 
instrument 的 文档 中 只 导出 DTrace 脚 本 。 


26.7 ”模板 

在 iOS、OS X 和 iOS 模 拟 器 中 有 22 个 Instrument 内 置 的 追踪 文档 模板 ， 正 如 你 看 到 的 那样 ， 你 也 可 以 添加 自己 的 模板 。 模 板 
帮助 界面 将 它们 分 为 4 部 分 : 每 个 平台 各 属于 一 部 分 ， 自 定义 的 属于 单独 的 一 部 分 。 

本 节 列 出 了 所 有 可 用 的 模板 以 及 它们 包含 的 instrument， 按 照 平台 排序 。iOS 模 拟 器 与 'OS 和 OS X 共 享 了 一 些 instrument， 
我 会 在 平台 列表 中 介绍 它们 。 


26.7.1 全 部 平台 


有 6 个 模板 属于 平台 无 关 的 : 它们 会 在 各 个 平台 列表 中 都 出 现 。 
- Blank: 不 包含 instrument 的 文档 
- Activity Monitor: Activity Monitor 
- Allocations: Allocations, VM Tracker 
- Leaks: Allocations. Leaks 
- System Trace: Scheduling, System Calls VM Operations 


- Time Profiler:Time Profiler 


26.7.2 {XMBRIOS 


下 面 这 7 种 模板 仪 能 用 于 iOS target， 不 过 其 中 有 一 个 模板 Automation 也 能 用 于 iOS 模 拟 器 。 
- Automation: Automation (也 能 用 于 iOS 模 拟 器 ) 


- Core Animation: Core Animation, Time Profiler 


- Energy Diagnostic: 这 里 有 一 些 分 析 器 ， 用 于 当 未 与 Instrumenhts 相 连 的 时 候 ， 记 录 设 备 信 息 ， 其 中 包括 Bluetooth、CPU 


Activity. Display Brightness. EnergyUsage,GPS. Network Activity、 Sleep/Wake、 WiFi. 
- GPU Driver: GPU Driver, Time Profiler 
- Network Connections: Connections 
- OpenGL ES Analysis: GPU Driver. OpenGL ES Driver 


- System Usage: I/O Activity 


26.7.3 仅 限 Mac 


有 9 种 模板 可 以 用 于 OS X 应 用 程序 ， 其 中 有 一 些 也 适用 于 模拟 器 。 
- Cocoa Layout: Cocoa Layout 
- Core Data: Core Data Cache Misses. Core Data Fetches. CoreData Saves (也 适用 于 iOS Simulator) 
- Counters: Counters 
- Dispatch: Dispatch 
- File Activity: File Activity, File Attributes, Directory I/O. Reads/Writes(also on iOS Simulator) 
- Multicore: Dispatch, Thread States 
- Sudden Termination: Activity Monitor, Sudden Termination 
- UI Recorder: User Interface 


- Zombies: Allocations， 用 于 提前 配置 追踪 僵尸 对 象 (同样 适用 于 iOS 模 拟 器 ) o 


26.8 小结 
Instrument 的 内 容 非常 多 ， 我 介绍 了 其 中 的 大 部 分 内 容 。 你 可 以 从 追踪 文档 窗口 开始 ， 然 后 过 渡 到 向 Library 窗 口中 添加 追 
踪 记 录 。 你 也 学 习 了 如 何 配置 instrument 追 踪 记 录 的 一 般 原 则 。 


你 了 解 了 启动 和 停止 记录 的 多 种 方法 ， 其 中 包含 用 尸 界 面 记录 ， 它 能 重复 播放 ， 这 样 束 能 为 你 的 应 用 程序 生成 可 重复 的 测 
试 。 


了 解 了 部 分 instrument 和 Apple 提 供 的 文档 模板 ， 以 及 如 何 创建 属于 你 目 己 的 模板 。 


随 着 需求 和 技术 提升 ， 你 可 能 想 要 查询 Instruments User Guide， 在 Xcode 的 Documentation 浏 览 跨 中 可 以 找到 这 
册 。 


第 27 章 ”调试 
调试 天 生 残 是 开 友 过 程 的 一 部 分 。 本 书 的 第 一 部 分 讲述 了 开 友 过 程 ， 其 中 也 讲述 了 基本 的 调试 技巧 。 在 本 章 中 ， 我 想 要 再 介 
绍 几 个 主题 ， 让 你 能 够 更 好 地 了 解 如 何 序 分 利用 Xcode 调试 器 和 其 下 的 lldb 调 试 系统 。 


我 们 将 会 观察 构建 sheme 中 的 Run 行 为 ， 以 及 如 何 为 你 的 调试 会 话 设置 条 件 。 之 后 ， 我 会 帮助 你 学 习 断 点 的 技巧 ， 而 不 仅 
仅 将 断 点 作为 程序 停止 的 位 置 。 同 时 我 们 也 会 看 lldb 调 试 器 的 命令 行 ，Terminal 和 调试 器 控制 台中 都 可 以 使 用 lldb 调 试 器 的 命令 
行 。 最 后 ， 介 绍 几 个 注意 事项 和 小 技巧 。 


27.1 Scheme 选项 


在 本 书 中 ，Scheme 频 繁 地 出 现 ， 但 是 我 想 要 介绍 用 于 Run 行 为 的 scheme 编辑 器 ， 在 这 里 你 可 以 完成 大 部 分 调试 工作 。 它 
包含 很 多 访问 OS 调试 特性 的 选项 。Run scheme 编 辑 器 有 4 个 选项 卡 ， 下 面 逐 个 介绍 。 


27.1.1 Info 


图 27.1 上 显示 了 Info 选项 卡 中 的 选项 。 
- 你 可 以 选择 是 否 Debug 整 个 Executable。 
你 可 以 选择 目标 运行 的 权限 等 级 。 
: 使 用 用 户 权限 (Me) 运行 和 调试 。 
- 使 用 root 权 限 (只 要 你 能 提供 admin 权 限 ) 运行 。 


一 般 情况 下 ， 你 想 要 Automatically (a) 运行 和 调试 应 用 程序 。 但 是 有 的 时 候 app 需 要 从 启动 它 的 进程 中 获取 特定 的 输 
入 和 人 条件 。Wait for executable to be launched 这 个 单 选 按 钮 会 让 lldb 等 待 直到 App 启 动 为 止 ， 开 始 运 行 后 lldb 再 附加 到 正在 运行 的 App 
进程 上 。 
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图 27.1 scheme 中 Run 行 为 的 Info 选 项 卡 (上 ) FeArgumentsit AF (F) 


27.1.2 参数 


Argument 面 板 (图 27.1 下 ) 有 两 个 表 : 一 个 用 于 命令 行 参数 ， 还 有 一 个 用 来 设置 环境 变量 。 使 用 + 或 者 -按钮 能 够 添加 或 者 
移 除 某 个 选项 。 每 个 条 目 旁 边 有 个 复 选 框 ， 所 以 在 运行 中 ， 你 可 以 选择 应 用 程序 使 用 哪个 设置 。 


参数 栏 中 可 以 包含 空格 ， 当 应 用 程序 局 动 时 ， 空 格 会 被 认为 是 参数 分 阳 符 。 也 丈 是 说 ， 它 们 会 在 传统 的 argv 数 组 中 生成 独 
立 的 条 目 。 如 果 你 想 要 传递 包含 空格 的 参数 ， 那 么 像 命令 行 中 一 样 用 反 和 斜 杠 转 义 。 


Expand Variables Based On 弹出 菜单 允许 你 在 参数 和 环境 变量 中 使 用 构建 变量 的 值 ， 仪 需要 像 这 样 包含 变量 的 名 字 : 
$ (SETTING NAME) 。 每 个 target 有 它 自己 的 构建 变量 集 ， 在 这 个 菜单 中 可 以 选择 使 用 哪个 变量 集 。 


27.1.3 选项 


Run 行 为 的 Options 选 项 卡 根据 target 是 Mac 还 是 iOS 而 有 所 不 同 。 这 些 控制 选项 影响 了 那些 没有 直接 与 系统 定义 的 环境 变 
量 相 匹配 的 运行 时 条 件 一 一 比如 位 置 、 工 作 目 录 、 图 形状 态 ， 以 及 你 是 否 需要 处 理 潜在 的 令 人 泪 形 的 特性 ， 比 如 启动 时 的 状态 


Mac 


如 果 你 勾 选 了 Allow Location Simulation ， 那 么 你 需要 选择 调试 环境 向 Location Services 报 告 的 位 置 。 你 可 以 从 位 置 菜单 


中 选择 一 个 ， 也 可 以 添加 一 个 GPX 文 件 构建 自 定义 的 位 置 。 


{TOS X 中 ，Cocoa 应 用 程序 具备 自动 状态 恢复 的 功能 ，OS 会 重新 打开 上 次 打开 的 文档 并 将 它们 配置 为 之 前 的 状态 。 如 果 你 
想 要 从 头 运 行 应 用 程序 ， 那 么 勾 选 Persistent State:Launch application without state restoration 选 项 ， 可 以 避免 很 多 头痛 的 


问题 。 


Versions 浏 览 器 的 工作 原理 是 将 之 前 版 本 的 文档 载 入 独立 的 文档 对 象 中 ， 然 后 自行 绘制 。 调 试 那些 瞬间 上 友 生 的 、 几 乎 相同 的 
文档 将 会 是 一 个 挑战 ， 但 是 如 果 你 需要 这 么 做 ， 勾 选 Document Versions:Allow debugging when using document Version 


Browser。 


POSIX 工 作 目录 是 Mac 开 上 的 一 个 痛 点 ， 因 为 当 Xcode 调 试 一 个 应 用 程序 的 时 候 ， 工 作 目 录 会 被 设置 为 包含 可 执行 文件 的 目 
录 。 而 从 Finder 中 局 动 应 用 程序 的 时 候 ， 得 到 的 工作 路 径 是 /， 也 融 是 文件 系统 的 根 目 录 (不 过 并 不 保证 这 一 点 ) . A 
选 “Working Directory: Use custom working directory”， 为 调试 运行 设置 工作 目录 。 这 里 有 一 个 用 来 输入 路 径 的 文本 框 ， 
还 有 一 个 打开 获取 文件 夹 界面 的 按钮 。 


在 第 21 章 中 ， 我 们 看 到 了 “本 地 化 调试 : 显示 非 本 地 化 的 字符 串 ” 有 关内 容 。 任 何不 是 从 .Iproj 本 地 化 目录 中 获得 的 文本 都 
会 显示 为 大 写 或 者 未 翻译 的 格式 化 字符 串 。 我 们 也 探索 了 Application Language 和 Application Region 这 两 个 弹出 窗口 的 功 


XPC 服 务 是 一 些小 的 可 执行 文件 ， 它 会 将 部 分 可 能 会 将 对 系统 造成 安全 威胁 或 者 让 应 用 程序 不 稳定 的 OS X 应 用 程序 分 离 出 
来 。 可 能 你 也 知道 现代 浏览 器 做 了 差不多 相同 的 事情 ， 它 会 阻止 插件 获取 浏 唤 器 属性 。 


如 果 勾 选 Debug XPC services used by this application ， 当 XPC 局 动 的 时 候 ，Xcode 惑 会 将 调试 器 附加 到 它们 身上 ， 作 为 
lldb 会 话 中 的 独立 进程 对 象 。 


View Debugging 是 Xcode 6 的 一 个 新 特性 。 如 果 局 用 这 个 特性 ， 你 融会 在 调试 器 的 应 用 程序 视图 结构 中 看 到 大 量 的 内 容 . 
稍 后 我 们 将 会 详细 介绍 。 
IOS 

iOS 选 项 用 来 处 理 模 拟 器 配置 和 在 设备 上 建立 调试 环境 。 下 面 是 仅 在 iOS 中 生效 的 选项 : 


当 你 将 启用 了 开发 功能 的 设备 与 Mac 连 接 的 时 候 ， 你 就 能 使 用 Devices ofganizet 寻 航 到 一 个 应 用 程序 ， 并 将 其 中 的 数据 解压 
到 一 个 数据 包 中 。 如 果 你 需要 重 现 一 个 bug， 而 这 个 bug 依 赖 于 应 用 程序 的 状态 ， 那 么 这 样 做 非常 重要 。 一 旦 你 将 数据 包 添 加 到 项 
目 中 ，Application Data 弹 出 菜单 将 会 选择 这 个 数据 包 ， 并 在 应 用 程序 启动 的 时 候 载 入 模拟 器 中 。 


- Apple 布 望 导 航 (路 线 选择 ) 应 用 程序 仅 为 全 球 部 分 地 区 提供 数据 。 你 可 以 上 传 一 个 尾 益 (GeoJSON) 文件 到 iTunes 
Connect 中 ， 这 样 应 用 商店 就 会 知道 你 的 应 用 程序 会 在 哪些 地 区 信 卖 。Routing App Coverage File 配 置 了 模拟 器 ， 它 会 将 你 的 应 用 程 


序 限制 在 这 些 区 域 中 。 


- 久 Xcode 调试 器 提供 了 大 量 工 具 用 于 调试 :OS 设备 上 面 的 OpenGL ES 和 Mental。GPU Frame Capture 能 够 启动 或 者 禁用 调试 器 控 


制 栏 的 帧 捕获 (frame-capture) 按钮 ， 它 允许 你 逐步 检查 构建 过 程 。 


` 如 果 你 需要 可 以 在 场景 后 面 下 载 的 资源 作为 数据 ， 那 么 OS 可 以 在 后 侣 启动 应 用 程序 。 义 选 Launch due to a background fetch 


event 会 模拟 这 种 类 型 的 启动 ， 而 不 是 强制 将 这 个 App 显 示 在 屏幕 上 。 


- XPC Services 值 得 提 及 ， 因 为 Xcode 6 使 用 这 个 选项 为 OS 扩展 添加 了 支持 。 


27.14 ik 


Diagnostics 选 项 卡 为 OS X 和 iOS 提 供 了 大 量 诊断 和 记录 选项 ， 之 前 这 些 选 项 都 是 由 环境 变量 控制 的 。 最 广为人知 的 一 个 选 
项 就 是 通过 将 NSZombieEanbled 设 置 为 YES， 就 能 检测 到 多 次 释放 的 对 象 。Diagnostics 将 最 常见 的 选项 用 复 选 框 显示 。 在 
Documentation 浏 览 器 中 搜索 Technical Note TN2124, Mac OS X Debugging Magic， 查 看 它们 的 描述 和 使 用 。 
Debugging Magic 中 的 内 容 (iOS 的 版 本 是 TN2239， 当 我 撰写 本 书 的 时 候 ， 它 已 经 不 可 用 ) 值得 完整 地 读 一 志 。 


Ore zombie 技 术 是 一 种 追踪 使 用 了 被 Cocoa 内 存 管理 系统 已 经 释放 的 对 象 的 有 效 手 段 。 一 般 情况 下 ， 访 问 已 经 释放 的 对 
象 将 会 导致 户 溃 ， 通 常 在 objc_msgSend 中 ， 你 的 App 会 尝试 向 已 释放 的 对 象 发 送 一 条 消息 。 有 的 时 候 可 能 会 访问 完全 不 同 的 对 
象 ， 这 是 因为 被 释放 对 象 的 地 址 可 能 已 经 分 配给 其 他 对 象 使 用 了 。 不 管 怎样 ， 都 很 难 确定 被 多 次 释放 的 对 象 是 什么 。 当 你 启用 了 
zombies 这 个 功能 的 时 候 ， 对 象 所 占 的 内 存 永远 都 不 会 被 释放 ， 它 们 简单 地 放 在 zombie 对 象 中 ， 这 些 对 象 会 记 住 旧 对 象 属 于 哪个 
类 ， 然 后 当 你 尝试 向 它们 发 送 一 条 消息 的 时 候 就 会 停止 执行 。 这 样 做 的 结果 就 是 App 在 第 一 次 准备 访问 这 个 对 象 的 时 候 就 会 前 溃 
同时 ， 你 至 少 知道 类 的 名 字 ， 这 样 就 能 缩小 导致 崩 





为 接 下 来 没有 机 会 继续 访问 这 个 对 象 ， 所 以 无 法 造成 进一步 的 危害 





渍 的 原因 。 在 这 个 面板 中 可 以 启用 Zombies 功 能 ， 通 过 环境 变量 ， 作 为 Allocation insttument 的 一 个 选项 。 


27.2 ”使 用 断后 做 更 多 的 工作 


很 多 开 友 者 ， 即 使 它们 也 经 常 使 用 断 点 ， 却 坚信 在 每 次 执行 一 段 代码 都 无 法 避免 朋 演 的 情况 下 ， 日 志 是 唯一 能 在 程序 外 获得 
控制 流程 和 状态 的 方法 。 事 实 上 并 非 了 这样 ， 如 果 你 人 在 本 章 还 没有 学 到 有 用 的 内 容 ， 那 么 记 住 这 点 : 几乎 不 用 在 应 用 程序 中 添加 
printin0、N3SLog0 或 者 其 他 打印 贸 效 。 


使 用 断 点 选项 蔡 代 NSLog()。 弹 出 窗口 中 的 选项 有 点 哮 人 ， 但 是 其 中 的 每 个 选项 都 有 它 目 己 的 目的 ,一 旦 你 明日 它们 能 做 什 
么 ， 束 能 充分 利用 这 些 选 项 ， 见 图 27.2。 
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图 27.2” 断 点 行为 能 提供 比 代 码 中 的 NSLog0 更 精确 的 日 志 


让 我 们 从 基于 println(0 的 Game.swift 中 的 代码 开始 。 


Var passerRating: Double { 
let rating = passer_rating ( 


completions: Int (self.completions!), 

attempts: Int(self.attempts!), 

yards: Int(self.yards!), 

touchdowns: Int (self.touchdowns!), 
( 


interceptions: Int(self.interceptions!) ) 


if theirTeam.hasPrefix("M") { 
printin("\(__FUNCTION__) - their team = \(theirTeam)") 


printin("\(self.description) ") 


} 


return rating 


想象 你 正在 追踪 传 入 Games 的 passer rating， 对 手 团队 的 名 字 由 M 开 头 。 可 能 会 发 生 以 下 情况 : 

1) 删除 If 语句 和 其 中 的 代码 ， 因 为 你 不 需要 它 。 

2) 单 击 return.… 旁 边 的 空 日 设置 一 个 断 点 。 

3) 右 击 断 点 箭头 ， 然 后 选择 Edit Breakpoint， 或 者 在 上 面 执行 简单 的 option-command-click 操 作 ， 弹 出 断 点 选项 。 


4) 你 仅 对 M 开 头 的 团队 感 兴趣 ， 所 以 在 Condition 栏 中 ， 填 入 刚才 if 语句 中 的 条 件 : 输入 
theirTeam.hasPrefix (“M”) 。 断 点 条 件 能 在 任何 语言 调试 时 执行 这 段 表达 式 。 对 于 Objective-C 表 达 了 式 ， 你 必须 对 返回 值 进 
行 强制 转换 ， 因 为 lldb 无 法 推断 出 每 个 可 能 的 方法 实现 的 返回 类 型 。Swift 对 返回 值 类 型 的 要 求 很 宽松 ， 所 有 你 不 需要 指定 。 


5) 在 Action 弹 出 菜单 中 ， 选 择 Log Message， 同 时 输入 %B-rating=@rating@。 在 @ 符 号 之 间 的 内 容 会 被 解释 成 表达 
式 ， 它 会 被 替换 成 对 应 的 消息 。 你 可 以 选择 说 出 这 些 消息 而 不 是 打印 它们 。 


SIS 你 也 可 以 选择 播放 一 段 声 音 、 执 行 一 个 调试 器 命令 、 一 段 shell 脚 本 或 者 AppleSctipt。 


6) AZ, @http://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15555/OEBPS/Text/..@ 表 示 法 可 能 并 不 像 你 想象 的 那样 实用 。 如 果 你 
想 要 打印 一 个 对 象 值 ， 这 种 语法 没有 帮助 ， 因 为 解释 器 只 能 看 到 一 个 指针 ， 并 打印 出 十 六 进 制 的 地 址 。 解 决 方法 是 使 用 
expression 调 试 器 命令 ， 比 如 ，expr-O-self， 而 -O 选 项 能 告诉 lldb 打 印 出 对 象 的 描述 信息 。 为 了 满足 熟练 使 用 gdb 的 开发 人 
员 ,，lldb 提 供 了 老式 写法 po 作为 别名 。 


FAE (+) 按钮 ， 并 添加 一 个 Debugger Command。 在 文本 域 中 输入 po self, 


7) 在 Options 中 ， 勾 选 Automatically continue after evaluating。NSLog(0 不 会 停止 执行 ， 所 以 断 点 也 不 会 阻 断 程序 的 执 


s- 


{To 
8) HHRH KRS eK. 


i 注意 ” 当 你 在 弹出 窗口 选项 中 为 一 个 断 点 匀 选 了 Automatically continue after evaluating， 替 换 NSLog0 的 调用 就 会 完成 。 当 
触发 了 断 点 ， 它 就 会 执行 对 应 的 所 有 行为 ， 但 是 不 会 让 程序 停止 。 


现在 运行 App， 残 会 友 现 调试 器 控制 台中 会 显示 断 点 的 位 置 、rating、 对 手 的 姓名 以 及 Game 对 象 的 内 容 。 


当然 ， 在 这 个 简单 的 例子 中 ， 构 建 满足 你 的 需求 的 日 志 代码 很 简单 ， 也 融 是 我 们 一 开始 做 的 事情 。 但 是 如 果 你 只 能 在 App 构 
建 完 毕 很 长 的 一 段 时 间 后 才能 看 到 这 个 错误 ， 并 且 你 想 要 测试 这 个 问题 ， 那 么 终止 这 个 ApPp， 然 后 插入 日 志 代 码 ， 重 新 构建 ， 再 


让 它 运 行 到 触 友 断 点 的 时 刻 的 做 法 并 不 实用 。 设 置 断 点 后 不 需要 重新 构建 ， 它 们 不 会 更 改 程序 自身 的 状态 (除非 你 主动 想 要 这 么 
做 ) ， 在 程序 运行 的 时 候 也 可 以 设置 断 点 。 


StH ”在 Xcode 的 早期 版 本 中 ， 当 你 在 Breakpoint navigator 中 设置 了 异常 或 者 符号 断 点 的 时 候 ， 你 将 会 自动 得 到 一 个 带 有 
断 点 选项 的 弹出 菜单 。 这 对 表达 式 来 说 很 实用 ， 因 为 异常 断 点 能 将 它 自己 限制 在 Objective-C 或 者 C++ 表 达 式 中 。Cocoa 内 部 有 些 
是 通过 C++ 实现 的 ， 它 们 能 自由 地 使 用 异 第 ， 所 以 你 将 会 看 到 大 量 的 错误 提示 。 右 击 新 设置 的 断 点 ， 然 后 在 上 下 文 菜单 中 选择 
Edit Breakpointhttp://www.hzcourse.com/resource/readBook? 


path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.... 
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我 曾经 提 到 过 Scheme 编辑 器 Options 面 板 的 Run 行 为 中 的 Enable user interface debugging 复 选 框 。 当 启用 了 UI 调试 的 时 
候 ， 一 个 是 按钮 就 会 出 现在 Debug 区 域 的 控制 栏 中 。 你 单 击 这 个 按钮 ，target app 就 会 停止 运行 ， 同 时 项 目 窗口 的 编辑 器 区 域 
束 会 显示 活动 窗口 的 视图 。 一 般 的 滚动 手势 会 从 模型 上 划 过 ， 拖 动 它 旋转 ， 同 时 -、= 和 + 按钮 可 以 放大 或 者 缩小 ， 见 图 27.3 上 .。 


Debug 调 试 器 右上 角 有 一 个 弹出 窗口 。 当 你 单 击 册 按钮， 菜单 会 被 设置 为 View UI Hierarchy， 另 外 的 选择 是 View 
Processes by Thread 和 View Processes by Queue， 它 们 会 显示 更 传统 的 栈 信息 。 在 UI 层级 视图 中 ，Debug 导 航 器 显示 了 窗口 
视图 的 完整 大 纲 ， 与 Interface Builder 中 的 文档 大 纲 相同 ， 但 是 更 加 彻底 。 
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调整 它 的 内 
况 图 底部 的 控件 会 调整 它 
) 视图 底部 
> a> a H 分 解 图 。 - Ase 4 一 
山 按 钮 就 会 显示 目标 应 用 程序 前 端 窗口 的 分 右 下 方 的 范围 滑动 器 会 隐藏 太 深 的 层 
ARSE HORAK SB 波 隐 藏 的 视图 ， i 
图 27.3 (E) 单 击 调试 器 控制 和 关 按钮 会 显示 那些 因为 约束 而 被 隐藏 
. . 第 一 个 开 ria A à 4 
、 > Ay A 
、 动 条 会 将 视图 分 开 ; 
容 : 左下 方 的 互动 条 
合 : 


当 UI 面 板 可 见 的 时 候 ，Utility 区 域 会 显示 两 个 新 的 查看 器 选项 下 


No 


Object 查看 器 (第 三 个 选项 卡 ) 提供 了 你 选中 的 视图 的 完整 信息 


` Size 查 看 器 (第 四 个 选项 卡 ) 显示 了 视图 帧 的 位 置 和 大 小 ， 以 及 Auto Layout 的 限制 。 


视图 底部 的 控件 会 调整 它 的 表现 。 


“ 左 侧 的 滑动 条 会 设置 视图 层 之 间 的 间隔 。 


Rr 


. 有 一 个 开关 可 以 显示 或 者 隐藏 已 经 存在 的 视图 ， 但 是 却 不 可 见 ， 因 为 它们 不 在 容器 的 范围 之 内 。 图 27.3 下 显示 Cocoa 已 经 
在 可 见 的 表 下 面 提 前 泻 染 了 game 表 的 行 。 


带 有 I-beam 的 方 框 横 跨 这 个 视图 ， 当 它 高 亮 的 时 候 ， 就 会 
同时 它 的 约 来 会 


显示 你 在 面板 中 选择 的 任何 视图 。 所 有 的 视图 都 被 线 框图 替换 ， 
显示 为 蓝 色 。 选 择 一 个 约束 应 该 在 Object 查看 器 中 显示 完整 的 细节 ， 但 是 截至 Xcode 6.1， 还 没有 这 个 功能 。 


` 第 三 个 按钮 会 恢复 视图 布局 的 比例 ， 将 它 居 中 显示 ， 并 且 将 正面 朝 上 显示 。 


“ 第 四 个 控件 是 一 个 弹出 菜单 ， 它 仅仅 会 显示 内 容 或 者 边界 的 线 框图 ， 或 者 两 者 都 显示 。 


右边 控件 的 双向 互动 器 控制 了 可 见 的 层级 。 将 左边 的 滑动 器 移动 到 右边 会 从 显示 的 视图 中 过 滤 挤 后 面 的 视图 ; 将 它 移动 到 
右 侧 会 移 除 前 面 的 视图 。 


27.4 lldb 命 令 行 


在 断 点 选项 的 弹出 窗口 中 使 用 条 件 和 命令 仅仅 是 lldb 命 令 行 的 初次 党 试 。lldb 命 令 很 多 ， 但 是 却 比 gdb 的 命令 更 加 紧凑 和 一 
致 。 没 有 人 能 确保 它 比 gdb 更 加 强大 ， 但 是 Apple 使 用 lldb 蔡 换 gdb 的 原因 之 一 融 是 gdb 的 设置 和 命令 选项 太 复 杂 ， 没 有 几 个 人 
能 够 充分 利用 它 。 


一 般 来 说 ，lldb 命 令 如 下 所 示 : 


noun verb options... arguments... 


noun 表 示 可 用 的 命令 ， 接 下 来 的 动词 和 选项 将 你 的 输入 精确 地 定位 到 指定 


选项 只 有 在 命令 行 中 才能 友 挥 最 大 作用 ， 不 过 大 部 分 选 I 


的 行为 。 下 面 是 一 个 内 置 的 调试 命令 分 类 。 部 分 
选项 都 包 闪 在 Xcode 的 调试 UI 中。 几乎 所 有 的 


IVAP > JI R 








选项 都 能 在 Xcode 调试 器 自己 
的 控制 台中 使 用 。 
.quit 一 一 如 果 你 正在 命令 行 中 使 用 ldqb， 你 首先 需要 知道 的 事 就 是 如 何人 退出 。 
apropos 和 help 一 一 它们 是 你 最 常用 的 命令 ， 至 少 在 一 段 时 间 内 是 这 样 。lldb 网 站 中 的 新 手指 引 很 不 错 ,， 但 是 它 无 法 窗 盖 每 
一 条 你 想 要 使 用 的 子 命令 和 选项 。4 


命令 行 帮 助 系统 是 最 佳 的 求助 资源 。 输 入 help breakpoint， 你 就 会 
关 的 一 个 动词 列表 ; help breakpoint set 将 


得 到 与 breakpoint 这 个 名 词 相 
会 向 你 展示 设置 断 点 可 用 的 选项 。 


加 注意 http://ldbJlvm.org/tuatoriaLhtml 中 的 教程 是 个 良好 的 起 点 。 





“ platform 一 一 lldb 的 核心 概念 就 是 组 合 和 控制 调试 会 话 的 容器 的 层级 。platform 是 最 外 层 的 容器 。 这 个 命令 可 以 让 你 检测 并 





选 出 lldb 能 作为 target 的 不 同 设备 和 架 枝 实例 同一 时 间 可 以 面向 多 个 应 用 程序 一 一 并 发 现 lldb 可 以 访问 的 进程 。 











使 用 target， 你 可 以 指定 一 个 可 执行 程序 作为 会 话 的 target。 你 可 以 指定 多 个 target， 而 不 需要 运行 第 二 个 lldb 实 例 
来 分 别 调试 服务 路 和 客户 端 。Xcode 提 供 当 另 一 个 target 正 在 运行 的 时 候 ， 你 也 可 以 运行 这 个 tatget 的 服务 。 它 会 弹出 一 个 界面 询问 
你 是 否 想 要 退出 存在 的 tareet， 如 果 你 选择 保持 已 存在 的 target 继 续 运行 ， 那 么 调试 器 就 会 同时 作用 于 这 两 个 实例 。 


- target 





它 是 lldb 容 器 的 第 三 层 。 你 可 以 启动 一 个 target (因此 创建 了 一 个 进程 ) 或 者 附加 到 一 个 已 经 存在 的 进程 上 。 进 
程 的 级 别 就 是 你 终端 执行 的 位 置 ， 发 送 一 个 POSIX 信 号 ， 或 者 终止 进程 。 


process 





` thread 一 一 调试 的 时 候 ， 你 考虑 的 大 部 分 内 容 都 属于 第 四 个 容器 。 线 程 级 别 中 可 以 获得 堆栈 追踪 记录 和 控制 程序 逐步 执 
行 。 
- frame 它 是 最 内 层 。 它 能 让 你 关注 当 执 行 停止 时 候 那 一 刻 的 帧 链 ， 也 就 是 堆栈 追踪 记录 的 级 别 。 在 这 一 级 中 ， 你 能 得 





到 大 量 的 变量 。frame variables 命 令 会 列 出 局 部 变量 (如 果 后 面 跟 上 - 〇 选项 ， 那 么 Objective-C 对 象 将 会 被 展开 ) 。 但 是 它 比 这 更 加 
灵活 ， 输 入 help frame vatiable 查 看 选项 列表 。 





已 能 创建 、 删 除 、 列 出 并 附加 条 件 和 脚本 到 断 点 上 。 因 为 你 能 附加 expression 命 令 到 一 个 断 上 点， 所 以 当 触 发 
断 点 的 时 候 ， 可 以 在 应 用 程序 中 执行 任何 你 喜欢 的 代码 。watchpoint 管 理 一 些 特殊 的 断 点 : 每 当 Mac 或 者 iDOS 设 备 上 的 变量 或 者 内 
存 发 生变 化 的 时 候 就 会 触发 watchpoint。 


”bteakpoint 





exptession 命 令 相 当 强 大 。 它 能 计算 并 打印 断 点 触发 时 所 在 文件 中 任何 表达 式 的 值 。lldb 谱 入 了 llvm 编 译 器 
库 ， 所 以 它 使 用 了 与 构建 应 用 程序 相同 的 编译 库 。expression 解 释 器 甚至 能 在 计算 表达 式 之 前 将 它 编译 为 机 器 码 。 


. expression 


表达 式 可 以 是 任何 类 型 : 可 以 做 赋值 和 自 增 操作 。 可 以 声明 本 地 或 者 全 局 变量 。 你 也 可 以 执行 条 件 语句 和 和 人 循环。 如果 你 想 
要 打印 Objective-C 对 象 ， 记 住 使 用 - 〇 选项 。 


KT 以 使 用 alias 命 令 为 最 第 使 用 的 命令 创建 快捷 方式 ; 1ldb 带 有 很 多 别名 ， 了 映射 到 gdqb 命 令 。command 命 令 也 
能 让 你 载 入 Python 模块 ， 在 Python 中 可 以 用 lldb 模 块 写 出 更 复杂 的 命令 ， 它 能 让 Python 完整 地 访问 lldb 的 内 部 状态 ; lldb 甚 至 允许 
Python plugins 访 问 目标 应 用 程序 的 内 存 空 间 ， 所 以 你 可 以 格式 化 对 象 的 内 部 数据 而 不 用 运行 对 象 的 任何 方法 。 





还 有 很 多 命令 我 无 法 在 这 里 一 一 列 出 ， 但 是 它们 都 很 实用 : 用 来 操纵 内 存 和 注册 器 的 命令 ; 列 出 源 代 码 或 汇编 代码 的 命令 ; 
创建 自 定义 配置 的 命令 。 在 Documentation 浏 览 器 中 查找 LLDB Quick Start Guide。 在 控制 台中 ，help 命 令 是 你 的 好 朋友 ， 可 
以 使 用 它 查看 命令 的 功能 及 用 法 。 


然而 ， 在 日 常 使 用 中 ， 大 多 数 人 会 发 现 使 用 在 命令 行 中 打印 状态 的 方法 来 调试 应 用 程序 实在 大 过 缓慢 。Xcode 将 绝 大 多 数 命 
令 都 包装 在 了 Ul 中 ， 用 一 种 更 直观 的 方式 在 屏幕 上 展示 整个 应 用 程序 的 状态 。 你 甚至 可 以 通过 将 摘要 格式 化 器 和 Python 定义 的 
孙 数 放 到 user-、target- 或 者 文件 夹 特定 的 .lldbinit 配 置 文件 中 来 使 用 这 些 功 能 。 


27.5 ”小 技巧 


下 面 是 一 些 能 帮助 你 调试 App 的 快速 提示 。 


默认 情况 下 ， 断 点 对 你 来 说 是 私有 的 一 一 团队 中 的 其 他 成 员 一 般 不 会 对 你 负责 的 工作 模块 感 兴趣 。 但 是 你 也 可 以 让 一 个 断 
点 变 为 公开 。 在 Breakpoint 导 航 器 (第 六 个 选项 卡 ) 右 击 ， 然 后 选择 Share Breakpoint， 断 点 就 会 移动 到 标记 为 “(Shared) ”这 一 


部 分 ， 然 后 其 他 用 户 就 能 看 到 这 个 断 点 。 


` 断 点 对 于 项 目 来 说 也 是 私有 的 。 默 认 情 况 下 ， 一 个 断 点 只 能 应 用 于 设置 这 个 断 点 的 项 目 。 如 果 工 作 空间 中 有 多 个 项 目 共 
一 个 源 文 件 ， 那 么 断 点 只 有 在 tatpget 运 行 的 时 候 才 会 触发 。 如 果 无 论 是 哪个 项 目 都 想 要 触发 这 个 断 点 么 在 Bteakpoint 导 航 器 中 
右 击 ， 然 后 选择 More Breakpoint To 一 Uset。 


` 变量 视图 占据 了 Debug 区 域 的 左 侧 (只 要 你 在 Debug 区 域 右 下 角 的 两 个 按钮 中 选择 了 左 侧 的 那 一 个 按钮 ) 。 一 个 非常 重大 
的 改进 就 是 Return Value 这 个 伪 变 常 你 会 使 用 像 下 面 这 样 (不 是 特别 ) 复杂 的 语句 : 


labelString = masterObject.dđdescriptionDictionary.objectForKey ("name") 


-descriptionDictionary 是 你 之 前 定义 的 一 个 方法 。 进 入 descriptionDictionary 方 法 中 ， 再 退出 。 程 序 计数 器 现在 仪 在 
objectForKey 的 调用 之 前 : objectForKey 是 什么 字典 : 要 友 送 到 ? 之 前 ， 没 有 办 法 知道 ， 除 非 深入 研究 栈 内 的 指针 。 现 在 
Return Value 变 量 视 图 中 的 行将 会 为 你 展示 。 


Site SARS APM, Retum Value 并 非 总 是 会 显示 ， 或 者 很 容易 忽视 它 一 一 在 机 器 码 级 别 ， 返 回 值 的 生命 周期 非 
常 短 斩 ， 返 回 值 会 被 用 来 赋值 或 者 传递 到 其 他 地 方 ， 事 实 上 ， 对 应 的 函数 调用 很 快 就 会 被 遗忘 。 


-也许 你 想 要 一 个 控制 台 窗 口 ， 使 用 命令 行 打 印 输出 、 完 成 应 用 程序 输入 以 及 调试 命令 。Xcode 6M KALROAR, 12 
是 它 目 适应 能 力 很 强 。 


- 在 导航 器 中 双击 任何 一 个 文件 ， 或 者 在 项 目 窗口 中 拖 出 一 个 选项 卡 ， 无 论 用 哪 种 方法 都 会 得 到 一 个 独立 的 窗口 。 使 用 这 个 
窗口 上 面 的 工具 栏 显 示 出 Debug 区 域 并 隐藏 Navigatof 区 域 。 将 Debug 区 域 顶部 的 工具 条 拖 到 窗口 的 顶部 ， 这 样 编辑 器 视图 就 会 消 
失 了 。 选 择 View 一 Hide Toolbat 让 工具 栏 消 失 。 使 用 窗口 右 下 角 的 显 隐 控件 ， 根 据 你 的 喜好 显示 出 变量 和 控制 台 视 图 。 


- 现在 你 就 有 了 一 个 控制 台 窗 口 。 它 还 不 够 完美 : 窗口 的 标题 栏 还 显示 着 从 窗口 编辑 器 中 拖 搜 出 来 时 用 的 名 字 。 同 样 ， 它 也 
非常 脆弱 。 如 果 你 的 某 个 行为 更 改 了 前 端 窗口 的 格式 ， 你 就 会 丢失 自己 的 布局 。 如 果 你 关闭 想 要 作为 “项 目 HBV, ABA “FH 
制 台 ”窗口 将 会 是 存在 的 最 后 一 个 窗口 ， 当 你 重新 打开 项 目 时 ， 就 会 仅 能 看 到 一 个 控制 台 ， 同 时 也 要 用 View 菜 单 将 自己 从 中 解 
放出 来 。 





-可 能 你 会 发 现 你 需要 为 目 己 授 权 一 可 能 会 重复 授权 一 来 开局 调试 器 和 Insttuments， 这 样 才能 让 你 检查 和 更 改 另外 一 个 
(也 就 是 你 想 要 调试 的 应 用 程序 ) 。 想 让 安全 对 话 框 不 打扰 你 的 工作 ， 可 以 在 命令 行 中 输入 sudo 
命 


DevToolsSecutity-enable 命 令 。 


` lldb 控 制 人 台中 的 po (print-object) 命令 将 会 打印 出 对 象 的 desctiption 方 法 (或 者 debugDesctiption ， 通 第 是 一 样 的 结果 ) 的 结 
果 。NNSObject 中 的 默认 实现 ， 仅 仅 会 打印 出 对 象 的 类 和 地 址 ， 帮 助 有 限 。 输 入 pxobjectVatiableName，1ldqb 就 会 将 对 象 视 为 C 的 结 
构 ， 然 后 显示 出 所 有 示例 变量 。 


Diz po 命令 仅仅 是 lldb 中 expression - O — objectVatiable 的 别名 。 
对 应 于 Swift 的 Printable 协 议 的 另外 一 种 值得 尝试 的 策略 是 输入 expr printin()” object.description” . 


曾经 提 到 过 ]ldb 命 令 行 中 的 watchpoint 命 令 家 族 ， 它 允许 你 设置 一 种 当 变 量 值 更 改 时 才 会 触发 ， 而 不 是 每 次 经 过 断 点 时 都 
会 触发 的 断 点 。 观 罕 点 能 让 你 找到 那些 由 于 值 的 更 改 而 引起 的 问题 。 


Xcode 为 观察 点 提供 了 图 形 化 的 界面 ， 但 是 它 并 不 明显 。 想 要 设置 一 个 观察 点 ， 首 先 要 在 变量 首次 进入 范围 内 的 地 方 设置 
一 个 无 条 件 断 点 一 一 在 lldb 能 够 识别 变量 之 前 ， 你 无 法 使 用 交 量 ， 同 时 变量 必须 要 在 当前 的 范围 内 ， 这 样 lidb 才 能 识别 它 。 在 变量 
面板 中 找到 你 感 兴趣 的 变量 。 如 果 你 对 对 象 内 的 某 个 变量 感 兴趣 ， 那 么 可 能 需要 单 击 提示 三 角 展 开 对 象 变量 。 右 击 变量 所 在 的 


行 ， 然 后 选择 Watch"vatiableName"。 下 次 这 个 变量 的 值 发 生 更 改 的 时 候 ，Xcode 就 会 在 这 里 停止 执行 。 


观察 点 在 源 代 码 中 没有 固定 的 位 置 ， 编 辑 器 视图 中 


也 没有 任何 标记 表示 观察 点 。 你 可 以 在 Bteakpoint 寻 航 器 的 特殊 分 类 中 
找到 观察 点 ， 可 在 这 里 编辑 、 取 消 激活 或 者 删除 某 个 观 罕 点 。 


- 观察 点 在 iOS 设 备 上 的 工作 方式 与 在 Macs 上 类 似 。 


当 你 开始 调试 的 时 候 ，Debug 区 域 顶 部 的 工具 栏 包含 所 有 的 步 进 或 者 其 他 流程 控制 按钮 ， 如 果 你 隐藏 了 Debug 区 域 ， 那 么 
它 在 项 目 窗口 的 底部 也 能 看 见 。 工 具 栏 的 左 侧 有 一 个 能 够 展开 或 者 收 起 Debug 区 域 的 控件 。 如 果 自 从 你 最 后 一 次 查看 Debug 区 域 


之 后 ， 控 制 台 又 打印 了 菜 些 信息 ， 那 么 这 个 控件 将 会 变 为 蓝 色 。 


- Debug 菜 单 为 调试 器 中 的 所 有 流程 控制 按钮 提供 了 菜单 和 快捷 键 。 如 果 你 想 在 输入 的 时 候 避 免 鼠 标 移动 ， 那 么 
Add/Remove Breakpoint at Current Line ( db / ) 和 Create Symbolic Breakpointhttp: //www.hzcourtse.com/resoutce/readBook? 


path= /opentesources/teach_ebook/uncompressed/15555/OEBPS/Text/... ($6\) 非常 实用 。 
Step Over 和 Step Into 命 令 (Debug 菜 单 和 调试 器 工具 栏 ) 有 两 个 额外 的 变量 : 


- Instruction 会 让 程序 计数 器 指向 当前 函数 中 的 下 一 条 机 器 指令 (Over) ， 或 者 执行 期 间 的 下 一 条 指令 ， 即 便 这 意味 着 它 
会 进入 下 一 个 函数 调用 中 Unto) 。 变 量 会 出 现在 菜单 中 ， 按 住 conttol 键 单 击 按钮 也 能 达到 相同 的 效果 。 


:Thread 有 一 点 复杂 。Cocoa 应 用 程序 是 多 线程 程序 ， 没 有 办 法 绕 过 这 一 点 。 当 你 执行 step-ovet 或 者 step-into 操 作 的 时 候 ， 
不 仅 会 让 调试 器 中 的 线程 向 下 执行 ， 其 他 线程 在 同一 时 间 也 会 向 下 执行 。 你 无 法 控制 其 他 线程 的 执行 ， 同 时 也 没有 执行 的 代码 以 
及 它 可 能 会 对 你 正在 调试 的 状态 有 什么 影响 。 当 你 让 当前 调试 的 线程 向 下 执行 的 时 候 ，Step Over Thread 和 Step Into Thread 会 冻结 

其 他 线程 。 单 击 Step Ovet 或 者 Step Into 按 钮 的 时 候 按 下 shift 键 或 者 conttol 键 ， 或 者 在 Debug 菜 单 中 选择 命令 ， 来 获得 这 种 效果 。 


.如果 你 习惯 在 命令 行 中 使 用 ldb， 那 么 你 可 以 设置 匹配 正则 表达 式 的 符号 化 断 点 。 比 如 ， 你 想 要 停 在 任何 以 passef 开 头 的 选 
择 器 进入 点 ， 那 么 可 以 在 breakpoint set 命 令 中 使 用 -+ 选项 。 
(lldb) breakpoint set -r passer.* 


Breakpoint created: 8: regex = 'passer.*', locations = 8, 
resolved = 8 


lldb 告 诉 你 创建 了 断 点 8， 用 breakpoint list 命 令 能 看 到 这 个 断 点 相关 的 信息 。 


(lldb) breakpoint list 8 
8: regex = 'passer.*', locations = 8, resolved = 8 


8.1: where = Mac Passer Rating’ 
-[LeagueDocument passerTable] + 16 


8.2: where = Mac Passer Rating 
- [LeagueDocument passerArrayController] + 21 


8.3: where = Mac Passer Rating 
- [PRGame passerRating] + 19 at PRGame.m:117 


这 个 命令 在 8 个 地 方 设置 了 断 点 (我 仅 显示 了 3 个 断 点 ) 。]ldb 将 断 点 的 位 置 分 离 了 出 来 。 输 入 bteakpoint delete 8 ， 就 能 删 


掉 这 个 8 个 断 点 。 
多 个 位 置 的 断 点 无 法 在 Xcode 中 的 Btreakpoint 导 航 器 中 显示 出 来 ， 也 无 法 显示 在 编辑 器 劳 边 的 空白 中 。 


- 有 的 时 候 Xcode UI 无 法 反映 出 代码 中 断 点 的 设置 。 这 种 情况 本 来 是 不 应 该 发 生 的 ， 但 是 却 有 可 能 发 生 。 在 lldb 命 令 行 汇总 
输入 breakpoint list， 找 到 在 Xcode UI 中 看 不 到 的 断 点 ， 然 后 使 用 breakpoint delete 命 令 清 除 不 想 要 的 断 点 ， 这 样 就 可 以 修复 这 个 问 


` 这 里 有 一 些 菜单 中 没有 的 内 容 ， 我 真 的 希望 它们 能 存在 于 菜单 中 : 如 果 你 在 调试 会 话 中 多 次 使 用 Step Into， 你 会 不 可 避免 
地 发 现 自己 进入 了 没有 调试 信息 或 者 没有 源 代码 的 函数 中 。 如 果 你 能 熟练 地 查看 这 种 代码 ， 那 么 你 已 经 不 需要 看 本 书 了 。 


` lldb 有 一 种 方法 可 以 跳出 : 在 lldb 命 令 行 中 输入 thread step-in — a true (-a 是 -avoid-no-debug 的 简写 ) ， 这 样 你 就 会 得 到 没有 调 


试 信息 的 最 后 一 帧 ， 所 以 在 没有 进入 你 的 代码 之 前 ， 调 试 器 不 会 停 下 来 。 


` 如 果 你 筷 记 在 异 第 的 时 候 停止 ， 最 后 你 会 发 现 还 是 会 停 在 一 个 地 方 ， 同 时 无 法 获得 调试 器 的 控制 权 ， 直 到 异 第 堆栈 在 运行 


MRR Peak, HE Amant se? 121k. 


- 你 可 以 阻止 OS X 应 用 程序 发 生 这 种 情况 ， 只 需要 在 Tetminal 命 令 行 中 将 用 户 默认 的 〈 偏 好 ) ~NSApplicationShowExceptions 
设置 为 YES 即 可 。 
$ # Set it for an app whose ID is com.yourdomain.application.id 
$ defaults write com.yourdomain.application.id\ 
> NSApplicationShowExceptions YES 


$ # Set it for every app you run: 
$ defaults write -g NSApplicationShowExceptions YES 


27.6 小结 


本 书 中 的 大 部 分 内 容 都 在 介绍 如 何 将 Xcode 调试 器 集成 到 日 常 工 作 流 中 。 而 本 章 则 为 你 提供 了 查看 细节 的 机 会 ， 让 你 能 从 高 
效 调 试 进 阶 到 融 练 掌握 调试 扩 能 。 





首先 ,我 们 抛弃 了 Xcode 项 目 模 板 提供 的 调试 环境 。 默 认 的 调试 环境 很 有 和 用， 但 是 还 有 一 些 细 书 一 一 环境 变量 、 地 点 感 
知 、 后 从 进程 和 与 子 任务 的 交互 一 一 会 让 你 的 应 用 程序 变 得 更 加 复杂 。 这 是 Scheme 编 辑 器 中 的 Run 行 为 应 该 做 的 工作 。 


FRR, 我们 研究 了 Xcode 断 点 的 功能 。 它 们 不 仅仅 能 让 程序 停止 ， 供 你 随意 查看 ， 你 还 可 以 创建 自己 的 断 点 ， 这 样 它们 束 
会 目 动 帮 你 收集 应 用 程序 如 何 运 作 的 信息 。 借 助 条件 、 计 数 和 打印 的 信息 ， 它 们 能 减少 那些 仅仅 是 为 了 能 得 到 App 执 行 的 日 志 而 
更 改 代 码 的 次 数 ; 或 者 多 次 单 击 Continue 按 钮 ， 只 为 了 能 够 等 到 重要 的 数据 到 达 。 


断 点 的 强大 功能 来 源 于 lldb 调 试 器 的 支持 。Xcode 的 调试 器 是 lIdb 的 包 沪 器 ， 它 也 是 一 个 非常 好 的 包 沪 器。 但 是 某 些 时 候 , 
你 可 能 需要 对 内 部 有 更 多 的 控制 力 和 洞察 力 。lldb 的 命令 行 语言 非常 直接 和 优雅 ， 同 时 我 也 向 你 展示 了 这 种 设计 的 哲学 理念 。 


UI Debugging 视 图 相当 优雅 并 且 实 用 。 之 前 我 已 经 向 你 展示 了 如 何 获 得 App 的 实际 的 视 于 展示。 视 完 上 面 的 问题 很 难 形象 


化 ， 需 要 你 化 费 大 量 的 时 间 解 决 这 绎 问题 。 


~ 


最 后 ， 我 介绍 了 一 些小 技巧 (但 是 我 希望 这 些 内 容 会 有 帮助 ) ， 它 们 在 长 时 间 的 调试 中 对 我 有 一 定 的 帮助 。 


第 28 革 ”零散 的 知识 


本 书市 你 浏览 了 如 何 使 用 Xcode 进 行 Cocoa 开 友 。 在 前 3 部 分 ， 我 尽量 介绍 了 更 多 的 内 容 ， 同 时 在 第 四 部 分 介绍 了 剩 下 的 较 
大 的 主题 。 现 在 还 有 一 些小 话题 一 技巧 和 陷阱 一 它 不 适合 放 在 前 面 的 任何 章节 中 。 


28.1 技巧 


28.1.1 一 般 技 15 


“ 如 果 你 习惯 使 用 UNIX 或 者 Linux 开 发 C 家 族 


能 自动 为 你 设置 。 


- ho RAK AEC P assert) KP AAA 
可 以 发 布 仍 带 有 断言 的 代码 ， 但 是 它 不 


拓 的 语言 ， 那 么 你 可 能 适应 了 全 局 宏 ， 比 如 NDEBUG 和 DEBUG， 并 且 期 待 它们 


零 ， 那 么 它 会 让 程序 停止 。 如 果 设 置 了 NDEBUG， 那 么 assert0 就 不 会 做 任何 事情 ， 所 以 你 


A pa 
BA TH o 


- NS_BLOCK_ASSERTIONS & 5 Cocoalf 3 Z P *ONSAssert #4, ASwifth wy Sw T RALF A. 


: 很 多 开发 者 喜欢 定义 DEBUG 宏 ， 用 来 保护 记录 和 断言 代码 。 


- Xcode 的 项 目 模板 为 Debug 配 置 定 义 了 DEBUG=1。 
码 大 小 的 一 种 简单 方法 就 是 打开 Target 编 辑 器 中 的 Build Settings 选 
得 到 一 个 用 来 输入 定义 的 表 ， 双 击 + 按 钮 添加 行 。 设 置 NDEBUG 和 NS_BLOCK_ASSERTIONS， 不 要 设置 DEBUG。 记 住 ， 


它 不 是 一 个 标准 的 宏 , 但 是 却 非 常常 见 。 


NDEBUG 和 NS_BLOCKK_ASSERTIONS 从 来 都 没有 设置 。 减 少 发 布 代 
先 项 卡 ， 后 双击 Pteptocessot Macots 设 置 Release 版 本 的 值 。 你 会 


包含 


${inherited} ， 以 保证 获取 在 其 他 级 别 中 保存 的 定义 。 


mY 注意 不 要 在 Proprocessor Macros 中 的 


5k YP 一 全 


符号 前 面 添加 -D， 虽 然 在 clang 命 令 行 中 需要 -D， 但 是 设置 中 不 需要 。 


(注意 ”设置 NS_BLOCK_ASSERTIONS 的 快捷 方法 是 在 Build Settings 选 项 卡 下 设置 Bnable Foundation 


Assettions (ENABLE NS ASSERTIONS) ， 


- Editor % #2 经 常 变 








会 根据 编辑 器 中 的 文件 类 型 调整 。 
索 栏 中 无 法 找到 ， 那 么 在 编辑 器 中 打开 与 这 个 功能 相关 的 文件 


在 调试 构建 中 将 这 个 值 设 置 为 Yes， 在 发 布 版 中 设置 为 No。 


-一 一 


如 果 你 确定 有 一 个 你 想 要 的 功能 ， 
后 单 击 这 个 文件 ， 


但 是 在 Help 菜 单项 部 的 搜 


类 型 2 


pa 整 Editot 菜 单 o 


复杂 的 项 目 中 ， 可 能 会 使 用 XIB 中 的 对 象 ， 作 为 提供 者 或 者 接收 者 ， 各 种 outlets、 行 为 和 绑 定 ， 每 个 都 带 有 与 它 相关 的 


编辑 器 。 不 需要 单 击 所 有 的 编辑 器 ， 


aK Swift LHF ( 


这 种 做 法 相当 聪明 , 但 是 有 一 
的 API， 所 以 也 就 不 在 Swift 中 针对 这 


但是， 如 果 你 编写 程序 的 时 候 使 用 了 一 个 函 





这 个 问题 。 为 了 适应 遗留 代码 的 .h 文 件 有 个 优点 ， 就 是 那些 过 
过 期 的 函数 。 在 Swift 接口 中 ， 你 只 能 


: 如 果 Swift 发 出 了 这 样 的 警告 ， 


一 个 .Swift 文件 的 时 候 你 无 法 这 样 做 
过 期 的 API 以 及 替换 这 个 API 的 新 函 


包含 由 import Swift 导入 的 Swift 本 身 ) 中 单 击 一 个 系统 提供 的 
整 的 注释 接口 文件 。 现 在 还 没有 这 样 的 文件 (至少 撰写 本 书 的 时 候 还 








选中 对 象 ， 选 择 Connection (第 六 个 ) 查看 器 ， 就 会 看 到 所 有 的 连接 。 


N 5g 


9 符号， 那么 将 会 看 到 定义 了 这 个 符号 的 完 


没有 ) 。 只 是 对 Objective-C(@interface 文 件 的 事实 转换 。 


TA 


勿 、: 


/> 


Fie ObjC 头 文件 中 Apple 标 记 为 过 期 的 API 并 没有 转换 ， 这 是 因为 Apple 不 鼓励 使 用 过 期 


EAPI 做 兼容 性 工作 了 。 


数 ， 后 来 这 个 函数 被 齐 用 了 ， 会 发 生 什 么 ? Apple 最 终 发 布 的 API 不 会 出 现 这 种 
a 
HAREE, TE IRA E EE RA A MAA A Ri HL 


知道 你 想 使 用 的 方法 已 经 不 存在 。 


We 
YL 


但 是 在 预 


后 输入 想 要 查找 的 符号 (HERR 
需要 的 头 文件 时 ， 双 击 ， 然 后 就 可 以 看 到 


那么 打开 Objective-C 源 文件 ， 选 择 File 一 Open Quickly， 然 


Xcode 将 会 强制 你 进入 Swift 接口 中 ) 。 当 你 看 到 需 


- 无 法 在 Objective-C 中 继承 一 个 Swift 类 。 如 果 声 明 任何 (@objc 和 public.clang， 那 么 将 会 提示 Cannot subclass a class with objc 
subclassing restricted atttibute。 每 个 Swift 类 都 有 它 自 己 的 属性 。 如 果 在 Swift 中 定义 一 个 类 ， 你 可 以 使 用 DObjC 扩 展 它 ， 但 是 它 的 子 


类 永 远 都 Fe Swift O 


- 在 Build Settings 表 的 底部 你 可 能 会 发 现 一 些 用 户 定义 的 条 目 ， 通 第 ， 这 是 Xcode 保 存 它 无 法 识别 的 设置 的 方法 。 它 的 识别 
方法 依赖 于 上 下 文 : 比如 ， 如 果 你 有 一 个 项 目 没 有 任何 可 兼容 的 文件 ，Xcode 不 会 载 入 编译 选项 列表 ， 这 些 选项 将 会 显示 为 用 户 
定义 的 。 


` 老 项 目 是 无 法 识别 的 设置 的 另外 一 种 来 源 。 在 Xcode 6 中 ， 有 一 些 选 项 不 再 支持 。 当 你 打开 一 个 项 目的 时 候 ，Xcode 可 能 会 
让 你 的 项 目 更 加 “现代 化 ， 也 就 是 移 除 了 那些 不 兼容 的 选项 。 到 底 要 怎么 做 取决 于 你 。 通 常 ， 这 是 一 个 好 想法 ， 但 是 如 果 你 与 
使 用 老 Xcode 或 者 OSes 的 其 他 开发 者 共享 项 目 文件 ， 这 些 设 置 可 能 仍然 是 相关 的 ， 你 可 能 为 了 它们 的 利益 保存 这 些 设置 。 


- 其 中 有 一 个 设置 $(inherited) 我 没有 提 到 过 。target 从 project 中 继承 构建 设置 ， 而 target 又 从 Xcode 的 默认 设置 中 继承 。 有 的 时 
候 你 想 要 添加 一 个 设置 ， 而 不 是 替换 设置 。 在 设置 中 使 用 $Ginhetited) 包含 继承 值 。 


.你 已 经 看 到 ， 当 你 向 项 目 中 添加 文件 的 时 候 ，Xcode 提 供 了 合并 文件 夹 作为 “文件 夹 引用 ”。Project 寻 航 器 中 有 两 种 不 同 
的 文件 夹 图 标 : 本 书 中 看 到 的 最 多 的 就 是 “分 组 ”文件 夹 。 一 般 来 说 ， 这 种 “分 组 ”文件 夹 是 简单 的 组 织 工具 ， 它 是 一 种 将 相关 


文件 聚集 在 一 起 的 方法 。 分 组 中 的 每 个 文件 本 身 是 项 目的 成 员 之 一 。 


. 但 是 有 的 时 候 ， 向 项 目 中 添加 一 个 文件 意味 着 添加 文件 夹 本 身 。 假 设 你 正在 构建 一 个 与 教育 相关 的 程序 ， 用 来 展示 美国 总 
统 。 你 想 要 应 用 程序 的 Resources 目 录 包 含 带 有 每 位 总 统 头像 的 子 文件 夹 。 你 的 意图 是 让 应 用 程序 包含 这 个 目录 以 及 这 个 目录 下 的 
所 有 文件 一 一 新 画像 或 者 旧 画 像 的 替代 品 





而 不 是 特定 的 文件 。 


` 在 这 种 情况 下 ， 当 你 添加 画像 文件 夹 的 时 候 ， 在 添加 文件 的 界面 你 需要 勾 选 Cfeate folder references for any added folders. #f 
添加 的 文件 夹 在 列表 中 的 显示 方式 与 在 Finder 中 一 样 是 蓝 色 的 文件 夹 ， 而 不 是 Xcode 中 用 来 标识 分 组 的 黄色 文件 夹 。 这 个 引用 文 
件 夹 之 后 可 以 拖 到 Copy Bundle Resoutces 构 建 阶 段 。 文 件 夹 和 它 的 内 容 ， 以 及 在 构建 中 生成 的 内 容 都 会 复制 到 产品 的 Resoutces A 
IK 


在 第 4 章 中 我 曾经 提 到 ，OS X 通 常会 替换 用 于 硬件 控制 的 默认 调试 控制 按键 (F) 。 你 不 会 因为 Xcode 的 选择 而 受阻 。 偏 
好 窗口 下 的 Key Binding 面 板 列 出 了 所 有 的 编辑 器 功能 和 应 用 程序 命令 ， 同 时 它 允 许 你 设置 或 者 更 改 与 它们 对 应 的 按键 。 默 认 的 设 
置 无 法 更 改 ， 但 是 单 击 + 按 钮 能 创建 自 定义 的 副本 。 


按键 表 头 部 的 Conflicts 按 钮 特别 有 用 ， 它 能 显示 Xcode 中 所 有 由 系统 指定 的 键 值 或 者 在 Xcode 中 指定 的 其 他 键 值 。 


Oa Xcode 中 可 用 的 文本 操作 非常 多 ;Key Bindings 表 中 的 列表 值得 一 看 。 你 会 发 现 非常 实用 的 编辑 行为 ， 比 如 move- 
by-subword (下 划 线 和 内 部 大 写字 母 ) (^Left- 或 者 Rieht-Atrow) ， 很 多 快捷 键 你 之 前 都 不 了 解 。 


: 之 前 我 已 经 多 次 强调 ，Project 导 航 器 并 不 是 一 个 目录 或 者 文件 系统 工具 ， 它 只 是 反映 了 项 目的 组 织 结构 ， 而 不 是 文件 系统 


目录 中 的 文件 存储 结构 。 这 种 说 法 并 不 是 非常 准确 。 


+ 如 果 一 个 Xcode 项 目 文件 引用 非常 明确 ， 那么 它 们 应 该 是 绝对 路 径 。 这 也 就 意味 着 所 有 的 文件 需要 使 用 从 主 目 录 开 始 的 路 
径 标 识 。 假 设 项 目 将 会 与 其 他 开发 者 共享 ,项目 及 其 文件 会 放 在 她 的 目录 中 。 而 你 的 主 目录 的 引用 将 会 是 错误 的 。 





` 解决 方案 看 起 来 应 该 是 使 用 相对 于 项 目 文件 的 路 径 这 的 确 是 一 种 选择 ， 不 过 ， 它 不 是 Xcode 的 默认 选项 。 默 认 选 项 是 
Relative to Gtroup， 就 像 在 File 查 看 器 中 显示 的 Location 弹 出 菜单 。 还 有 其 他 一 些 选 择 ， 比 如 相对 于 构建 的 产品 、 相 对 于 Xcode 的 内 


部 Developetr 和 SDK 目 录 ， 当 然 也 有 绝对 路 径 。 如 果 你 已 经 定义 了 资源 树 ， 你 也 可 以 让 路 径 相对 于 其 中 一 个 路 径 。 


“但 是 “相对 于 组 ”是 什么 意思 ? 如 果 你 单 击 一 个 文件 夹 组 ， 你 会 在 File 查 看 器 中 看 到 这 个 组 也 有 路 径 〈 当 然 ， 它 可 能 是 绝 
对 路 径 或 者 相对 路 径 ) 。 组 不 是 目录 : 多 个 组 可 以 指向 相同 的 文件 夹 ， 而 且 组 中 所 有 的 成 员 并 非 都 在 相同 的 位 置 。 


` 在 组 中 添加 一 个 文件 系统 的 位 置信 息 有 个 优点 : 在 文件 系统 中 ， 你 可 以 有 两 个 包含 相同 文件 名 称 的 目录 。 可 能 其 中 一 个 包 
含 实际 的 列 ， 另 外 一 个 用 来 测试 。 在 两 个 文件 夹 之 间 切 换 将 会 变 为 更 改 对 应 组 的 路 径 。 如 果 组 目录 不 包含 组 中 的 文件 ， 那 么 这 个 


文件 的 路 径 将 会 是 相对 于 项 目的 路 径 。 


重 命 名 是 Project 了 导航 器 提供 的 另外 一 项 文件 管理 服务 。 它 使 用 与 Findef 中 一 样 的 手势 : 重 命名 一 个 文件 或 者 组 ， 首 先 单 击 
选中 ， 然 后 过 几 秒 再 次 单 击 ， 文 件 名 就 会 进入 可 编辑 状态 。 或 者 ， 选 中 要 重 命名 的 条 目 ， 按 下 tetutn 键 。 


:如果 项 目 处 于 版 本 管理 状态 下 ，Xcode 将 会 做 一 些 必 要 的 工作 ， 保 证 代码 仓库 了 解 了 这 次 改动 。 


- 假设 你 已 经 在 Objective-C 头 文件 中 写 了 如 下 代码 : 


extern NSString * const PRPFirstNameKey; 
extern NSString * const PRPLastNameKey; 
extern NSString * const PRPCurrentTeamKey; 


“ 同时 你 想 要 在 实现 文件 中 添加 对 应 的 声明 。 一 般 情 况 下 ， 首 先 要 做 的 就 是 粘贴 头 文 件 中 的 声明 。 停 下 。 按 下 option 键 ， 你 
会 发 现 鼠 标的 光标 已 经 被 更 改 为 十 字 光 标 。 从 第 一 个 单词 extefn 的 首 字母 开始 拖 动 ， 一 直到 单词 的 最 后 一 个 空格 。 


这 样 你 就 完成 了 列 选择 。 按 下 delete 键 ， 所 有 的 externs 都 会 被 删除 。 
` 这 是 一 个 编辑 器 特性 ， 而 不 单单 是 Objective-C 才 有 这 样 的 功能 。 


:如果 你 能 在 列 中 输入 并 将 文本 显示 在 每 一 行 中 将 会 非常 好 ; 或 者 复制 一 行 ， 在 文本 的 任意 位 置 单 击 ， 粘 贴 ， 并 让 列 的 内 容 
插入 到 插入 点 和 行 下 面 。TextMate 能 做 到 这 一 点 ， 但 是 Xcode 无 法 做 到 这 一 点 。 


- 默认 情况 下 ，Find 导 航 器 会 直接 搜索 项 目 中 的 文本 文件 。 就 像 你 在 第 7 章 中 看 到 的 那样 。 全 局 搜索 有 一 些 简 单 的 选项 
选项 都 很 容易 理解 。 这 里 还 有 一 些 高 级 特性 : 


i= 


` 可 以 搜索 的 内 容 不 仅 限 于 文本 。Finder 导 航 器 顶部 的 级 联 弹 出 菜单 不 仅 提供 了 文本 和 正则 表达 式 ， 还 有 References 〈 仅 能 
用 于 你 输入 符号 ) 和 Definitions (每 个 头 文件 声明 和 函数 /变量 定义 ) 。 在 Finder 一 Definitions 一 Matching stat(Lenoring Case) 中 执行 
搜索 操作 ， 就 会 看 到 8 个 与 StatView 类 相 匹 配 的 项 ， 它 的 statLayet let 变 量 ; GameListConttollef.swift 中 的 StatsLabel enum 常 量 ; 还 有 


TodayViewConttollet 中 StatViews 的 5 个 @IBOutlets。 不 需要 其 他 子 字 符 串 ， 仅 仅 是 定义 。 


全 局 搜索 栏 左 下 面 是 一 个 标签 ， 上 面 写 了 一 些 普通 的 文字 如 In Ptoject 或 者 In Wotkspace。 它 是 一 个 按钮 ， 处 于 项 目 (项 
目 处 于 工作 空间 中 ) 大 岗 的 一 侧 。 如 果 你 已 经 将 所 有 子 系统 的 文件 放 到 分 组 中 ， 那 么 你 将 会 得 到 缩小 子 系统 搜索 范围 的 一 种 非常 


棒 的 方法 。 


` 在 大 纲 中 有 另外 一 种 分 类 Seatch Scopes， 开 始 的 时 候 它 是 空 的 ， 除 了 一 个 名 为 New 
Scopehttp:/ /www.hzcourse.com/tesoutce/teadBook?path= /openresoutces/teach_ebook /uncompressed/15555/OEBPS/Text/...#9 4% 
符 。 单 击 这 个 占 位 符 就 会 弹出 一 个 菜单 用 于 命名 和 定义 一 个 自 定义 搜索 范围 。 在 图 28.1 中 ， 我 定义 了 一 个 Property Lists 范 围 ， 包 
含 工 作 空间 中 的 文件 ， 同 时 还 带 有 plist 扩 展 名 。 如 果 在 这 个 范围 内 搜索 包含 wt9t 的 文本 ， 我 将 仅 会 看 到 Info.plist 前 置 文件 中 的 


bundle 和 文档 ID。 


站 富力 ô = ai g $) Passer Rating > GameDB ) Utilities > a rating.swift > No Selection 


Find » Definitions + Containing 
Q- stat (x) 
=== |ñ Property Lists gnoring Cases 
a results in 3 files 
SEARCH SCOPES 
a Property Lists Find in files where all of these conditions are true: 
| New Scope... 


Property Lists 


Location is within workspace 


PROJECT Path Extension is equal to plist 
v 加 Passer Rating a - 


< 





A281 单 击 全 局 搜索 栏 下 面 的 范围 按钮 ， 就 会 打开 一 个 搜索 范围 列表 ， 还 能 自 定义 搜索 范围 ， 在 本 例 中 ，property-list 文 件 在 工 
作 空 间 中 


28.1.2 RBE 


在 第 二 章 中 ， 我 曾经 让 你 禁用 Xcode 的 一 些 特性 ， 所 以 进入 Preference 窗 口 的 Text Editing 面 板 ， 关 闭 了 Show:Code 
folding ribbon。 这 个 特性 非常 实用 ， 但 是 也 有 些 “ 阿 噪 ” 一 -一 当 折 姥 线 可 见 的 时 候 ， 将 鼠标 移动 到 编辑 器 的 左 侧 空白 处 ， 融 会 


很 多 文本 编辑 器 都 实现 了 折 填 : 单 击 一 个 控件 ， 通 党 处 于 空 日 处 ， 或 者 使 用 一 个 菜单 命令 或 者 快捷 键 ， 编辑 器 束 会 折 革 所 选 
部 分 的 文本 。 可 能 很 长 的 代码 束 会 折 革 成 一 行 ， 所 以 束 能 从 更 高 的 层次 观察 函数 的 结构 。 


代码 折 苹 ribbon 也 完成 了 实现 了 相同 的 功能 : 打开 这 个 功能 ， 融 会 在 gutter 和 编辑 器 的 文本 部 分 添加 一 条 ribbon。 文 本 量 
越 大 ，ribbon 的 颜色 越 深 。 当 你 将 鼠标 移动 到 ribbon 的 时 候 ，Xcode 玖 会 高 亮 显 示 广 本， 显示 包 仿 这 一 行 的 代码 块 。 单 击 
ribbon 残 能 将 这 块 文本 折 填 ， 见 图 28.2。 


被 折 苹 的 文本 会 用 一 个 市 有 省 略 号 的 黄色 气泡 蔡 换 。 双 击 这 个 气泡 或 者 单 击 折 苹 市 芳 边 的 提示 三 角 就 会 展开 文本 。 你 可 以 在 
Editor 一 Code Folding 的 子 菜单 中 找到 代码 折 羡 的 菜单 命令 以 及 对 应 的 快捷 键 。 


var arrangedGames: [Game]? 于 
if let passer = llItem # 


y isn't known, and there's a 
ray and remember it. 
let amas = passer. gi » as NSSet 
let dateSort = NSSortDescriptor(key: 
ascending: true) 


aR sor eE E E ET E E 
as? [Game] 


var arrangedGames: [Game]? £ 
if let passer = detailltem 





a L array ind remember it. 
let ES = passer. al as NSSet 
let dateSort = NSSortDe escriptor(key: 
ascending: true) 


aa sortedArrayUs ingDescriptors([dateSort]) 
as? [Game] 


return 


Var arrangedGames: [Game]? i 
if let passer = deta: n 


return . ai 





图 28.2 ” 当 你 在 偏好 窗口 的 Text Editing mÈ M Yk NW, RAI BribbnteseARHASWMAY AM SARRTA-AME 
带 。 将 鼠标 移动 到 折 县 带 (上 ) 就 会 高 沈 显 示 这 一 级 别 的 代码 (或 者 更 深 一 层 的 代码 ) 。 (中 ) 移动 到 低 一 级 别 就 会 让 高 充 范 转 
Ib] RIKER (T) 单 击 tibbon 就 会 折 有 司 高 亮 区 域 。 它 的 内 容 就 会 用 带 有 省 略 号 的 气泡 表示 ， 同 时 fibbon 旁 边 也 会 出 现 一 个 提示 

三 角 


28.1.3 ”Assistant 编辑 器 


你 已 经 使 用 Assistant 编 辑 器 做 了 很 多 工作 ， 但 是 我 想 在 一 个 地 方 介绍 所 有 的 基本 信息 : 当 你 单 击 Editor 控 件 中 间 的 
segment 的 时 候 ，Assistant 编 辑 器 就 会 显示 在 Workspace 窗 口 的 工具 栏 中 。 当 你 按 下 option 键 导航 到 一 个 文件 的 时 候 ， 它 也 会 
显示 出 来 。 


- Assistant editor 最 令 人 兴奋 的 功能 就 是 它 能 记录 主编 辑 器 中 显示 的 文件 ， 并 显示 与 之 对 应 的 文件 ， 如 与 .m 文 件 相 对 应 的 .h 文 
件 ， 或 者 与 .c 文 件 相 对 应 的 .h 文 件 。 如 果 有 多 个 对 应 文件 一 一 比如 ， 当 一 个 私有 接口 中 包含 两 个 关 文 件 的 时 候 一 一 那么 按 下 Up 键 


或 者 | 键 或 者 单 击 assistant 跳 转 栏 中 的 箭头 按钮 ，Counhtetpatt assistant 将 会 在 这 3 个 文件 之 间 切 换 。 


.自动 填充 Assistaht 编 辑 器 的 选项 不 仅仅 是 对 应 文件 : 你 可 以 指向 类 层级 结构 中 与 之 相关 的 文件 ， 相 关 的 Ihtetface Builder X 


件 ， 包 含 主编 辑 器 的 文件 或 者 被 主编 辑 器 包含 的 文件 ， 以 及 中 间 内 容 ， 比 如 汇编 和 反 汇 编 。 就 像 我 在 第 5 章 中 提 到 的 ，assistant 能 
展示 所 选 济 数 的 调用 者 或 者 被 调用 者 ， 同 时 它 示 执 行 所 选 函 数 的 测试 方法 。 


` 将 目标 文件 放 在 assistant 面 板 的 Option-keys 手 兵 可 以 修改 。Preference 窗 口中 的 Naviegation 面 板 能 让 你 自 定义 Xcode 如 何 响 应 
导航 手势 : 


+ 简单 地 单 击 导 航 器 就 能 跳 转 到 主编 辑 器 〈 左 侧 的 大 编辑 器 ) 或 者 此 时 你 正在 使 用 的 编辑 器 。 


- 按 住 option 键 单 击 文件 就 能 将 所 选 文件 发 送 到 Assistant 编 辑 器 ， 其 中 带 有 额外 的 assistant 面 板 、 一 个 新 选项 卡 或 者 一 个 新 


. 双击 就 能 将 文件 放 到 一 个 新 窗口 或 者 一 个 新 选项 卡 中 。 


一 步 讲 ， 如 果 你 使 用 option 或 者 shift 键 导航 ，Xcode 将 会 为 你 提供 一 个 heads-up 显 示 器 ， 为 你 提供 一 个 图 形 化 的 选择 
器 ， 用 来 将 文件 放 在 一 个 已 经 存在 或 者 新 的 视图 中 ， 见 图 28.3。 


PasserEditlableController.switt 





28.3 ” 当 你 选择 文件 的 时 候 ， 按 下 option 和 shift 键 ，Navipgation Chooset 就 会 显示 出 来 。 它 是 一 个 图 形 化 的 浏览 器 ， 能 让 你 选择 显 
示 哪 个 文件 。 菜 单 中 与 之 相同 的 命令 是 Navigate 一 Open in。 一 个 新 窗口 会 显示 在 Cover Flow 的 左边 ; 已 经 存在 的 选项 卡 中 有 一 个 


占 位 符 ， 还 有 一 个 新 窗口 横 跨 展示 的 顶部 


-你 可 以 有 多 个 Assistant 视 图 ， 视 图 的 右上 角 有 一 个 + 按钮 ， 用 来 添加 一 个 新 视图 。 当 然 ， 穷 边 的 X 按 钮 是 用 来 关闭 视图 
的 。 


. 你 不 必 拘 泥 于 并 排放 的 主编 辑 器 和 Assistant 编 辑 器 。View 一 Assistant Editor 子 菜单 为 你 提供 了 竖 直 摆 放 还 是 水 平 摆 放 的 选 
， 或 者 按照 行 或 者 列 串 联 所 有 的 编辑 器 。 将 assistaht 放 在 主编 辑 器 下 面 能 使 在 Intetface Buildet 和 源 文 件 之 间 拖 搜 outlet 和 action 连 
接 更 简单 。 





28.1.4 Instruments 和 调试 


“ 值得 重申 的 是 : eee 两 种 技术 笔记 : OS X Debugging Magic (TN2124) 和 iOS Debugging Magic (TN2239) , ix 


20, 点 IQ 值 。 


- Leaks 和 Allocations insttuments 处 理 了 大 多 数 内 存 问题 ， 但 并 不 能 处 理 所 有 问题 。 有 的 时 候 ， 一 些 不 再 使 用 的 对 象 仍然 存 
在 于 内 存 中 ， 但 是 因为 它们 还 有 一 些 残留 的 引用 ， 所 以 无 法 按照 泄露 处 理 。Allocations 在 它 的 选项 区 域 中 有 一 个 名 为 Matrk Heap 的 
按钮 。 启 动 应 用 程序 ， 待 程序 平稳 运行 后 单 击 Matrk Heap， 然 后 做 一 些 消耗 内 存 的 操作 ， 不 过 仍然 要 恢复 到 原始 状态 一 一 比如 打 
开 一 个 文档 ， 然 后 编辑 它 ， 再 关闭 它 。 重 复 这 样 做 ， 再 次 标记 堆栈 。 








堆栈 快照 分 析 表 将 会 向 你 展示 已 经 创建 但 是 在 进程 结束 后 没有 回收 的 所 有 对 象 。 并 非 所 有 的 对 象 都 会 残留 一 一 对 象 会 在 组 
存 中 正常 增长 一 一 但 是 你 应 该 知道 这 些 对 象 的 存在 都 是 合理 的 。 

- Apple 工 程 师 Bil Bumgarnet 为 此 写 了 一 篇 优秀 的 文章 。 在 网 上 搜索 他 的 名 字 和 heapshot 关 键 词 就 能 找到 这 篇 文章 。 
28.1.5 ”构建 


- 编译 器 中 出 现 的 警告 都 是 有 原因 的 ， 虽 然 这 不 是 关于 Xcode 的 小 提示 ， 但 是 我 们 都 应 该 牢记 于 心 。 clang 和 swiftc 非 常 JET -i 
于 捕获 常见 的 编程 错误 和 违反 Cocoa 依 赖 的 编程 约定 的 代码 。 支 持 论坛 ( 见 附录 B) 上 提出 的 很 多 问题 都 是 与 忽略 的 警告 有 关 。 


修复 每 一 个 警告 ， 然 后 运行 分 析 器 (Product 一 Analyze，B) ， 然 后 修复 这 些 警 告 。 


. Xcode 假设 产品 构建 的 时 候 使 用 Run 行 为 [或 者 Product->Build 后 B) ， 它 是 Build for Running 的 同义词 ] ， 生 成 的 产品 用 于 
调试 ， 不 适合 发 布 给 其 他 用 户 使 用 ; 而 Atchive 构 建 适用 于 对 外 发 布 ， 相 对 少见 。 因 此 Xcode 很 容易 找到 构建 出 的 文件 。 


对 于 atchive 构 建 ， 打 开 Atchives organizer (Window 一 Organizer， 第 二 个 选项 卡 ) ， 选 中 atchive， 然 后 单 击 
Exporthttp: //www.hzcoutse.com/resoutce/teadBook?path= /openresoutces /teach_ebook /uncompressed/15555/OEBPS/Text/.... A 7K 


多 选项 可 以 用 来 保存 可 执行 文件 ， 最 简单 的 方法 是 Export as a Mac Application Save for iOS App Store Deployment. 


对 于 重新 构建 ， 执 行 构建 操作 ， 在 Project 导 航 器 中 的 Products 组 中 找到 对 应 的 产品 ， 然 后 在 上 下 文 菜单 中 选择 Show in 


Finder o 


在 第 25 章 中 我 曾经 说 过 ee AAAA A 个 文件 分 别 用 于 调试 和 发 布 ， 那么 你 无 法 通 
过 tafpget 的 Debug 和 Release 配 置 切换 文件 。 对 于 库 文 件 来 说 ， 要 求 没有 那么 。 解 决 方法 是 将 库 从 Link Binary With Libraties file 中 
取出 来 ， 然 后 构建 系统 就 不 会 把 库 文件 放 在 链接 命令 中 ; 同时 我 们 将 所 需 的 库 名 称 填写 在 Other Linker 
Flags (OTHER_LDFLAGS) 构建 设置 中 。 





在 Tareet 编 辑 器 的 Build Settings 选 项 卡 中 ， 搜 索 other 找到 这 个 设置 。 打 开 淮 边 的 提示 三 角 ， 双 击 Debug 配 置 中 的 值 ， 然 后 单 
击 + 按 钮 在 列表 中 添加 一 项 。 通 过 在 新 行 中 输入 -lmyhame debug Æ% (假设 它 的 名 字 是 libmyname_debug.a) 。 然 后 ， 为 库 的 
release 版 本 做 同样 的 工作 。 


“ 在 构建 时 期 ， 这 些 标志 位 将 会 添加 到 链接 命令 行 中 ， 带 有 对 应 调试 版 本 或 者 发 布 版 本 的 名 字 ， 这 依赖 于 配置 。 


“ 链接 器 中 有 很 多 选项 用 来 控制 哪些 库 应 该 链接 到 可 执行 文件 中 。 特 别 的 是 ， 对 于 OS X 构 建 来 说 ， 它 总 是 优先 链接 动态 链 
接 库 (.dylib) 而 不 是 静态 链接 库 Ca) 。 你 可 以 在 链接 命令 行 中 填写 静态 库 的 全 路 径 来 修改 这 个 问题 。 只 需要 添加 库 的 全 路 径 到 
Other Linker Flags (OTHER_LDFLAGS) 构建 设置 中 ， 路 径 中 要 包含 后 级 和 lib 前 级 。 使 用 BUILD_PRODUCTS_DIR 构 建 变量 而 不 
是 目录 路 径 ， 能 减少 对 机 器 中 文件 路 径 的 依赖 。 





- lvm 中 的 优化 设置 标记 划分 为 从 -O0 (一 点 都 不 优化 ) 到 -O3 (优化 所 有 内 容 ) 。 当 力求 应 用 程序 运行 起 来 无 比 顺畅 的 时 





需要 打开 所 有 优化 选项 。 可 是 Xcode 中 标准 的 Release 优 化 设置 是 -Os 它 用 来 优化 包 大 小 。 这 么 做 有 什么 好 处 ? 
 -O3 这 个 优化 选项 的 问题 是 : 它 会 显著 地 增 大 生成 代码 的 大 小 : lvm 会 目 动 将 函数 调用 转化 为 内 座 代 码 ， 所 以 这 些 函 数 将 


会 在 应 用 程序 中 重复 多 次 出 现 。 它 将 会 把 for 循 环 挨个 蔡 换 为 n 个 枚 举 循环 ， 因 为 直接 运行 4 份 相同 的 代码 比 保 存 一 个 计数 器 ， 然 
后 在 条 件 分 支 中 比较 4 次 后 再 运行 更 快 一 些 。 


所 有 的 优化 都 是 独创 性 的 ， 但 是 它们 也 未 考虑 周全 。 现 代 人 处理 器 的 处 理 能 力 比 访问 主 存 的 速度 要 快 很 多 。 等 待 数据 的 载 入 或 
者 程序 执行 会 降低 处 理 器 的 处 理 效 率 。 因 此 ， 在 处 理 器 和 RAM 之 间 添 加 了 高 速 缓存 ， 它 能 让 指令 流 与 CPU 的 处 理 速度 保持 同 
步 。 但 是 缓存 的 大 小 有 限制 。 当 添加 了 内 联 代 码 并 展开 后 ， 应 用 程序 是 原来 的 两 售 大 ， 它 将 会 让 缓存 过 载 ， 执 行 一 条 指令 至 少 需 
要 访问 两 次 内 存 。 通 党 情况 下 ，“ 快 速 ”代码 会 比 小 代码 运行 的 速度 更 慢 。 所 以 将 Release 配 置 的 优化 设置 改 为 -Os。 


DFR Swift 的 优化 选项 有 些 不 同 ， 从 -Onone 到 -Ofast 到 -Ounchecked。Swift 编 译 器 没有 使 用 无 缓存 的 CPU; -Ofast 基 本 上 等 


于 clang 中 的 -Os， 其 中 还 包含 运行 时 的 安全 检查 。 


- 对 于 Objective-C 来 说 ，clang 努 力 改善 内 存 管理 和 API 更 迭 的 兼容 。 使 用 一 个 过 期 的 方法 ， 传 入 带 有 tetainVtelease 语 义 的 
@selectot 导 致 clang 无 法 明白 或 者 使 用 用 于 格式 化 字符 串 的 字符 串 变 量 都 会 得 到 警告 。 


` 但 是 有 的 时 候 你 知道 自己 在 做 什么 不 想 被 这 些 警 告 折磨 ， 为 你 知道 没有 什么 可 担心 的 。clang 通 过 命令 行 中 的 标记 
如 -Wdeprecated 取 消 过 期 函数 的 警告 。 


- 在 整个 target 中 搜索 构建 设置 并 将 它 关 闭 ， 就 可 以 禁止 所 有 的 警告 。 你 可 能 不 想 这 样 做 : 你 对 遇见 的 这 些 警 告 都 经 过 了 
仔细 的 思考 ， 对 吗 ? 你 可 能 想 要 知道 其 他 过 期 函数 发 出 的 警告 。 


` 你 可 以 仅仅 针对 一 个 文件 关闭 人 警告。 在 Compile Sources 构 建 阶段 的 表 中 找到 它 ， 然 后 双击 那 一 行 。 你 会 得 到 一 个 弹出 窗 
口 ， 在 这 个 窗口 中 输入 仅 针 对 这 个 文件 的 编译 选项 在 这 个 例子 中 是 -Wno-deprecated。 这 种 做 法 的 控制 力度 很 细 ,， 但 是 并 不 明 





隔离 关心 的 那些 和 它 放 在 #ptasmas 之 后 ， 将 会 保存 clang 的 警告 状态 ， 告 诉 它 忽略 过 期 的 函数 ， 然 后 在 有 问题 


#pragma mark -UISearchDisplayContollerDelegate 
#pragma clang diagnostic push 
#pragma clang diagnostic ignored "-Wdeprecated" 


// UISearchDisplayController is deprecated in iOS 8. 
// Low priority; won't fix for now. 
- (BOOL) searchDisplayController: 
(UISearchDisplayController *)controller 
shouldReloadTableForSearchString: (NSString *)searchString 


FE aes 
} 


#pragma diagnostic pop 


28.2 ”陷阱 


FELII YE, XcodehSHWiRER, KEARE LFS, MEARAH AMS MiK SL FAM AE ee 


受制 于 bug 和 各 种 各 样 琐碎 的 事 。 下 面 有 一 些 内 容 要 注意 : 


“ 在 大 多 数 编辑 文档 的 OS 义 应 用 程序 中 ， 包 含 proxy icon 的 标题 栏 代表 文档 文件 。 你 可 以 随意 拖 动 它 ， 就 像 在 Finder 中 拖 动 文 
档 一 样 。 如 果 单 击 标题 栏 的 时 候 按 下 conttol 键 或 者 command 键 ， 就 会 出 现 一 个 包含 目录 路 径 的 下 拉 菜 单 。 选 择 一 个 条 目 就 能 打开 
对 应 的 文件 夹 。 


Xcode 将 它 的 整个 工具 栏 都 移动 到 了 标题 栏 中 ， 所 以 没有 位 置 显示 文件 名 或 者 proxy icon。 当 一 个 文件 显示 在 一 个 编辑 器 视 
图 中 的 时 候 ， 跳 转 栏 中 条 目的 行为 就 像 常规 窗口 中 的 proxy 和 标题 的 作用 。 





当 你 从 源 文件 中 移 除 一 个 @IBOutlet 的 时 候 ，clang 和 Swift 会 迅速 做 出 反应 ， 在 项 目 中 标记 出 所 有 错误 和 警告 但 是 不 包 
含 XIB 和 stotyboard 中 的 outlet 连 接 。 直 到 NIB 载 入 器 抛 出 异常 ， 针 对 丢失 的 outlet 名 字 说 目标 对 象 is not key-value coding compliant 的 
时 候 ， 才 知道 这 个 IBOutlet 已 经 被 移 除 。 一 旦 你 更 改 了 一 个 outlet (或 者 一 个 @IBAction) ， 就 要 迅速 检查 检查 Intetface Builder? 
相关 的 对 象 。 大 多 数 对 象 都 会 在 File 的 Ownet 中 ， 选 中 其 中 的 一 个 然后 使 用 Connection 查 看 器 〈 第 六 个 选项 卡 ) 查看 丢失 的 连接 。 


- 如 果 你 仅仅 更 改 了 一 个 Objective-C outlet, AR A 4% H Edit—Refactor—Renamehttp: //www.hzcoutse.com/tresoutce/teadBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/...。 重 构 机 制 会 安全 实时 的 更 改 I[B 文 档 中 相关 的 内 容 。 


了 简单 起 见 ，Xcode 仅 仅 用 一 个 空 的 搜索 栏 表 示 文 档 内 搜索 。 应 该 还 有 一 些 选项 。 搜 索 栏 左 侧 的 放大 镜 下 有 一 个 下 拉 
单 ， 其 中 的 第 一 个 选项 就 是 Show Find Options。 选 中 它 就 能 看 到 一 个 弹出 菜单 ， 里 面 有 各 种 选项 ， 比 如 : 大 小 写 敏 感 、 前 级 、 后 
级 、 部 分 匹配 还 是 整 词 匹 配 ， 是 否 是 正则 表达 式 等 。 


- 单 击 任 何其 他 地 方 一 一 比如 这 个 弹出 窗口 都 会 消失 。 弹 出 窗口 消失 后 就 没有 明确 的 指示 说 下 一 次 搜索 将 
会 执行 什么 样 的 操作 。 你 的 选择 仍然 保留 ， 你 要 么 记得 之 前 做 出 的 选择 ， 要 么 单 击 放大 镜 按 钮 ， 然 后 在 菜单 中 选择 一 个 选项 。 如 
果 文 件 内 的 搜索 栏 中 出 现 了 令 人 惊讶 的 结果 ， 那 么 请 检查 设置 。 





如 果 结 果 令 人 吃惊 ， 但 是 你 不 知道 它们 是 什么 (如 果 你 知道 文件 中 有 什么 ， 那 就 不 需要 搜索 了 ) ， 
bug， 就 太 糟 烧 了 。 但 是 你 可 以 使 用 一 个 整洁 的 搜索 栏 。 


而 遇 到 了 一 7 


CY 


+ 传统 的 正则 表达 式 引 营 都 在 替代 区 域 中 使 用 区 表示 用 来 匹配 搜索 结果 的 完整 字符 串 ， 但 是 在 Xcode 中 使 用 $0。 


“ Xcode 版 本 管理 支持 的 一 大 缺陷 是 tags (标签 ) 。 当 完成 了 一 个 重要 的 里 程 碑 ， 比 如 茶 个 版 本 发 布 ， 可 能 你 会 想 要 使 用 一 
个 名 字 标 记 这 个 版 本 ， 将 来 可 能 会 让 项 目 回 到 这 一 刻 。 所 有 的 版 本 控制 系统 都 允许 你 做 到 这 一 点 ， 但 是 Xcode 无 法 设置 、 显 示 或 
者 回 退 到 指定 的 标签 。 你 必须 进入 命令 行 模 式 ， 使 用 git tag 或 者 svn cp 子 命令 完成 这 个 操作 。 


:如果 你 查看 用 于 Xcode 字 典 的 AppleScript Editor 应 用 程序 ， 你 将 会 看 到 扩展 脚本 的 用 途 ， 比 如 ， 程 序 化 地 创建 并 配置 Xcode 
项 目 。 可 能 因为 对 Xcode3 的 引用 让 你 感到 不 安 。 根 据 经 验 来 讲 ， 如 果 你 喜欢 一 一 部 分 命令 的 执行 都 如 它 描 述 的 那样 。 大 多 数 都 
不 一 样 。 


你 可 以 脚本 化 Xcode 用 于 文本 转化 一 一 也 就 是 说 ， 从 节 数 声明 中 生成 文档 注释 。OS X 和 之 前 的 NeXTStep 将 它 标记 
为 sefvices， 你 可 以 在 应 用 程序 菜单 的 Setvices 子 菜单 或 者 上 下 文 菜单 中 找到 过 
知道 只 有 当 文 本 被 选中 的 时 候 提 供 基 于 文本 的 服务 一 一 同时 可 以 使 用 服务 工具 的 输出 替换 选中 的 文本 。 





- OS X 的 Automatot 特 性 在 脚本 和 服务 链 中 生成 了 小 程序 ; 你 可 以 使 用 Automatot 创 建 一 个 服务 。 这 个 编辑 器 
在 /Applications/Utilities 中 。 创 建 一 个 文本 ， 然 后 选择 Service 类 型 。 浏 览 Library 边 栏 查 看 系统 和 应 用 程序 为 你 提供 的 行为 。 


. 举 个 例子 : Swift， 类 似 于 C++， 内 部 通过 继承 对 象 对 范围 和 属性 的 完整 描述 来 区 分 对 象 ， 由 此 完成 符号 过 载 和 命名 空间 
的 功能 。 编 译 过 的 二 进 制 文件 的 完整 标识 类 似 于 工 FC17Mac Passer 


Rating20 League ViewControllerm1 9teamA rrayControllerGSQCSo17NSArrayController-. 
` 将 上 下 文 设置 为 Service receives selected(text)in(any application) 。 
从 Library 列 表 中 拖 动 Run Shell Script. 
- 设置 Pass input:(to stdin)， 所 以 选中 的 文本 将 会 作为 输入 流传 入 脚本 。 
- 输入 xcrun swift-demangle - compact 作 为 脚本 。 


- 在 脚本 下 拖 动 Copy to Clipboard， 所 以 连接 器 将 会 统一 。 





:将 Service 保 存 为 方便 的 名 称 ， 比 如 Demangle Swift Symbol (没有 文件 位 置 与 之 相关 它 会 进入 保存 在 Automator 服 务 中 


的 目录 ) o 
. 退出 并 重新 打开 任何 你 想 要 使 用 这 项 服务 的 应 用 程序 (比如 Xcode) 。 
- 选中 符号 和 Xcode 一 Setvices 一 Demangle Swift Symbol (或 者 在 Services 上 下 文 的 子 菜单 中 选中 相同 的 命令 ) 。 


. 粘贴 。 结 果 应 该 是 Mac Passer 


Rating, League View Controller. teamA rrayController.materializeForSet: ObjectiveC. NS AtrayController! 。 
在 System Preference 的 Keyboard 面 板 中 为 你 的 行为 设置 一 个 系统 级 的 热 键 。 


- 你 使 用 Xcode 构建 的 大 多 数 targets 都 会 包含 一 个 Info.plist 文 件 ， 构 建 系 统 将 会 处 理 它 ， 并 将 它 安装 在 最 终 的 产品 中 。 不 幸 的 
是 ， 这 个 文件 的 路 径 可 能 会 出 现在 target 的 Copy Bundle Resources 构 建 阶 段 。 这 样 就 会 与 构建 系统 发 生 冲 突 。 如 果 构 建 的 时 候 出 现 
了 


这 种 情况 ，Xcode 会 警告 你 。 


一般 情况 下 ， 源 文件 不 仅仅 只 在 Copy Bundle Resources 阶 段 中 。 这 种 情况 发 生 在 如 果 你 匀 选 了 将 C 家 族 的 .h 文 件 添加 到 target 
中 的 时 候 。 这 不 需要 构建 产品 ， 编 译 器 将 会 自己 查找 并 解释 它 的 头 文 件 。Xcode 会 把 添加 到 target 关 系 的 行为 理解 为 你 想 要 将 这 个 
文件 作为 bundle 资 源 。 


` 你 无 法 在 多 个 编辑 器 中 打开 一 个 XIB 或 者 storyboard。Interface Builder 生 成 的 产品 从 字面 上 说 是 Cocoa 对 象 文档 。 同 时 访问 一 


个 网 络 对 象 是 一 件 非常 头痛 的 问题 ， 所 以 我 并 不 会 责备 Apple 将 它 的 资源 分 配 放 到 各 个 地 方 。 


- 当 你 将 一 个 NSTextView 拖 搜 到 Intetface Buildet 中 的 时 候 ， 实 际 上 拖 搜 的 是 NSSctollView 中 的 NSTextView 和 它们 之 间 的 
clipping 视 图 (在 第 20 章 中 你 已 经 看 到 了 同样 的 事 ) 。 如 果 你 打算 将 一 个 outlet 与 文本 视图 相连 ， 那 么 可 能 需要 先 终 止 与 sctoll view 
的 连接 (或 者 什么 也 不 用 做 ， 如 果 这 个 outlet 的 类 型 只 接受 文本 视图 ) o 


` 问题 在 于 滚动 视图 可 能 会 比 文本 视图 大 ; 文本 视图 的 高 度 与 它 所 包含 的 文本 的 高 度 一 致 。 在 视图 中 添加 一 些 Lorem ipsum 
文本 ， 拖 动 与 它 相 连 的 连接 器 ， 你 就 会 与 文本 视图 相连 。 
-作为 一 个 动态 语言 ，Objective-C 编 译 器 允许 任何 对 象 都 能 接收 任何 消息 。 实 现 方 式 可 能 完全 不 相关 ; 所 有 的 编译 器 必须 要 


做 的 就 是 载 入 接收 器 ， 选 择 器 和 栈 中 的 参数 ， 然 后 调用 分 发 的 消息 。 


加 注意 Swift 的 AnyObiject 对 象 提 供 了 同样 的 自由 度 ， 但 是 它 不 会 让 你 向 对 象 发 送 一 个 消息 ， 直 到 你 将 它 转化 为 实现 了 这 个 


方法 的 类 或 者 原型 一 一 它 将 会 约束 返回 值 ， 并 消除 这 个 问题 。 


“ 这 种 方式 工作 得 相当 好 ， 但 是 理想 情况 被 现实 中 的 返回 值 打败 了 : 返回 值 可 能 是 一 个 数字 、 浮 上 点数、 指针 ， 或 者 一 个 结构 


体 ， 它 们 依赖 处 理 器 的 架构 ， 这 些 结果 可 能 存储 在 完全 不 同 的 位 置 。 编 译 器 不 得 不 生成 从 正确 位 置 获取 结果 的 指令 。 


. 如 果 方 法 的 所 有 实现 都 带 有 一 个 指定 的 签名 返回 相同 的 结果 类 型 ， 那 么 一 切 都 还 好 。 只 要 编译 器 已 经 看 到 了 这 个 方法 的 一 
带 类 


些 声 明 ， 它 就 能 处 理 这 个 方法 。 即 使 编译 器 看 到 了 带 有 不 同 返回 类 型 的 声明 ， 如 果 已 知 接收 的 对 象 类 它 仍然 能 做 出 正确 的 行为 。 


当 接 收 者 声明 为 idq 或 者 Class 的 时 候 ， 就 会 打破 这 一 条 规矩 ， 因 为 它 没有 明确 地 说 明 这 个 方法 的 实现 或 者 返回 值 。 在 过 去 ， 
编译 器 会 安静 地 猜测 你 想 要 的 是 什么 返回 值 ， 所 以 就 会 导致 大 量 隐 了 星 的 bug。clang 现 在 要 求 你 在 接收 器 的 方法 调用 上 使 用 强制 转 
换 来 规避 二 义 性 。 





- HFS+， 它 是 OS X 推 荐 的 文件 系统 ， 根 据 保 存 的 文件 而 有 所 不 同 文件 将 会 使 用 与 你 提供 的 名 字 一 样 的 名 字 但 是 它 
大 小 写 不 敏感 : Xcode.tfxt、XCODE.TXT 和 xcode.txt 指 向 的 都 是 同一 个 文件 。 大 部 分 其 他 UNIX 变 量 都 是 大 小 写 敏 感 的 ， 所 以 如 果 


你 导入 代码 的 时 候 ， 一 定 要 注意 类 似 下 面 的 情况 ， 这 两 行 导入 的 是 完全 不 同 的 文件 : 





#include "polishShoes.h" 
#include "PolishShoes.h" 


基于 同样 的 原因 ， 请 确保 代码 引用 文件 名 的 时 候 大 小 写 一 致 。 即 使 你 不 想 移植 你 的 工作 ，HFS+ 也 不 是 Macintosh 应 用 程序 
能 使 用 的 唯一 文件 系统 ， 并 且 在 i0S 中 ，HFS+ 大 小 写 敏 感 。 但 是 : iOS Simulator 运 行 在 OS X 文 件 系 统 上 ， 也 融 是 说 这 个 iDS 运 
行 在 模拟 器 中 ， 所 以 其 中 的 HFS+ 大 小 写 不 敏感 。 
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附录 A 一些 构 建 变量 


这 个 列表 简短 ) 列表 。 构 建 变 量 决 定 了 编译 标识 、 


这 里 提供 了 控制 Xcode 构建 系统 主要 构建 变量 的 简单 (虽然 你 可 能 不 完 得 
完整 解释 可 以 在 Documentation 浏 览 器 中 找到 ， 只 需 


搜索 路 径 、 安 六 行为 和 一 些 基 本 信息 ， 比 如 产品 名 称 。Xcode 构 建 变 量 的 
要 搜索 Build Setting Reference 即 可 。 


如 果 想 要 看 Run Script build phases 中 所 有 可 用 的 构建 变量 ， 只 需要 创建 一 个 仪 包含 一 行 的 phase， 然 后 勾 选 Show 
environment variables in build log。 执 行 一 次 构建 ， 在 Log 导 航 器 (第 八 个 选项 卡 ) 的 顶部 找到 这 次 构建 ， 然 后 选择 Al 和 All 
Messages 过 滤器 。 单 击 script phase， 人 在 行 的 右 侧 束 会 显示 出 文本 行 按 钮 。 


你 会 友 现 那 里 有 将 近 350 个 变量 。 本 附录 中 列举 了 很 多 实用 的 变量 。 举 个 例子 ,构建 的 条 件 如 表 A.1 所 示 。 


表 A.1 ” Setting 的 构建 环境 示例 


Prolect PasserRating SDK iOS 8.2 
Target Passer Rating Target 6.2 
Product Passer Rating.app 10.10.2 
Configuration | Debus | 


wt 我 选择 了 一 个 不 同 的 名 字 ， 这 样 你 就 能 区 分 自动 设置 的 变量 的 原始 值 。 项 目 模 板 的 主 tateet、scheme 和 产品 名 称 有 





相同 的 值 。 一 般 不 用 更 改 它 ， 但 是 可 以 更 改 。 我 将 tatget 和 构建 sheme 的 名 称 保留 原样 ， 因 为 构建 系统 永远 都 不 会 查看 scheme 的 
名 字 。scheme 仅 仅 用 来 组 织 targets 的 构建 配置 。 配 置 及 它们 对 应 的 设置 对 构建 系统 有 作用 ， 而 不 是 选择 它们 的 方式 对 构建 系统 有 
VE Jle 

Target 或 Project 编 辑 器 的 Build Settings 选 项 卡 中 并 没有 包含 所 有 设置 的 对 应 接口 。 你 可 以 自己 添加 这 些 配置 一 一 如 果 它 们 
并 非 只 读 一 一 选择 Editor 一 Add Build Setting 一 Add User-Defined Settings。Xcode 将 会 在 列表 中 添加 一 个 新 行 ， 你 可 以 在 
Setting 列 中 输入 设置 的 名 字 ， 然 后 在 你 想 要 设置 的 级 别 下 面 为 其 赋值 。 布 尔 类 型 的 变量 应 该 输入 YES 或 者 NO。 


构建 变量 正式 的 名 字 是 它 的 “设置 名 字 ” 一 一 它 是 实际 构建 变量 的 名 字 ， 在 环境 变量 中 可 见 ， 也 可 以 在 其 他 设置 和 
Info.plist 扩 展 中 替换 。 在 Build Settings 选 项 卡 的 搜索 栏 中 输入 设置 的 名 字 、 普 通 的 名 称 或 者 描述 信息 中 的 任意 部 分 ， 束 能 找到 
对 应 的 条 目 。 


SFR 设置 可 以 根据 条 件 更 改 ， 比 如 说 专门 针对 某 个 处 理 器 架构 构建 或 者 使 用 哪个 SDK。 详 情 见 第 25 章 。 


Build Settings 选 项 卡 可 以 显示 设置 名 称 而 不 是 描述 性 的 “设置 标题 ”。Editor 菜 单 中 的 Show Setting Names/Show 
Setting Title 选 项 能 在 “真正 的 ”名 字 和 描述 标题 之 间 切 换 。 


同样 ， 你 也 可 以 控制 如 何 显示 设置 的 值 。 一 个 设置 可 能 由 另外 一 个 设置 定义 ， 比 如 当 你 通过 $(HOME)/Applications 指 定 一 
个 安 半 目录 的 时 候 ， 默 认 情 况 下 ，Xcode 会 显示 仍 入 的 展开 的 构建 变量 ， 因 为 构建 系统 仪 仪 能 识别 完整 的 展开 后 的 字符 串 。 
Editor 荣 单 中 的 Show Definitions/Show Value (针对 未 展开 的 值 表 达 式 ) 选项 能 更 改 显 示 方 式 ， 显 示 字 面值 (Definitions) 
或 者 经 过 解析 的 值 (Values) 。 


实用 的 构建 变量 


言 归 正 传 ， 下 面 是 经 过 挑选 的 构建 变量 的 列表 。 我 将 它们 按照 通用 功能 分 组 ， 在 各 个 分 组 中 ， 按 照 从 一 般 到 特殊 的 顺序 排 
列 。 


其 中 有 一 些 变 量 已 经 废弃 了 : Apple 不 再 为 它们 提供 文档 ， 黔 认 情况 下 target 模 槐 也 不 绸 使 用 它们 。 构 建 系 统 仍然 将 它们 视 
为 环境 变量 ， 这 是 为 了 向 后 兼容 run-script build phase， 但 是 新 建 项 目 开 及 的 时 候 不 要 使 用 它们 。 


其 他 这 一 部 分 显然 是 有 用 的 ， 但 是 Xcode 没有 暴露 出 预定 义 的 描述 或 者 为 它们 提供 默认 值 。 通 常 ， 这 些 设置 必须 拥有 从 其 他 
设置 中 继承 的 值 ， 获 蓄 它 们 将 会 导致 构建 失败 。 


环境 


下 面 是 一 些 在 脚本 中 或 者 构建 其 他 构建 设置 时 可 以 使 用 的 只 读 变 量 。 





-PROJECT 一 一 Xcode 项 目的 名 称 ， 不 带 有 扩展 名 。 除 非 有 覆盖， 否则 PROJECT_NAME 将 会 油 用 这 个 设置 。 


(PasserRatin g) 


- ACTION 





xcodebuild 行 为 的 名 称 ， 它 从 命令 行 中 输入 ， 或 者 由 Xcode 生成 ， 用 来 匹配 触发 构建 的 Product 行 为 。 
(build) 
- PORJECT_NAME 一 一 包含 构建 目标 的 项 目 名 称 。 大 多 数 中 间 文 件 和 目录 的 路 径 中 都 会 包含 这 个 名 字 。 


.PLATFORM_NAME 一 一 目标 平台 的 名 字 ， 比 如 macosx、iphonesimulator 或 者 iphones。 这 个 设置 马上 就 要 弃 用 了 ，Apple 文 
档 中 已 经 不 再 有 这 个 变量 。 


(macosx) 

- PRODUCT NAME 一 一 目标 包 和 二 进 制 文件 的 名 字 ， 没 有 前 级 、 后 级 或 者 扩展 名 的 修饰 。 
(Passer Rating) 

FULL PRODUCT NAME 一 一 目标 包 的 文件 或 者 目录 名 称 。 

(Passer Rating.app ) 


- PRODUCT TYPE 一 一 反 DNS 风 格 的 标识 符 ， 表 示 target 生 成 的 产品 类 型 。 它 在 构建 过 程 中 定义 了 终止 点 ， 构 建 系统 会 通过 
它 推 断 生 成 产品 的 所 有 步骤 。 (com.apple.product-type.application) 


- HOME 一 一 主 目 录 的 名 字 ， 与 bash 中 HOME 变量 的 功能 类 似 。 
USER 一 一 执行 构建 的 用 户 名 。 与 它 对 应 的 还 有 一 个 数字 用 户 ID 名 为 UID。 
- GROUP 一 一 执行 构建 的 人 所 在 的 分 组 。 与 它 对 应 的 还 有 一 个 数字 分 组 ID 名 为 GID。 


-PATH 一 一 标准 UNIX 的 PATH 环境 变量 ， 指 定 了 调用 UNIX 命 令 时 候 的 搜索 目录 〈 根 据 Xcode 工 具 链 的 不 同 ， 这 个 路 径 也 有 
所 不 同 ， 在 一 般 的 文件 系统 中 还 跟随 着 标准 的 目录 ) o 


- MAC_OS XxX_VERSION_ACTUAI 一 一 6 个 数字 组 成 的 版 本 号 ， 指 定 了 构建 操作 基于 的 OS 又 的 版 本 号 。 前 两 个 数字 是 10 
三 个 数字 是 10， 最 后 的 数字 表示 最 低 版 本 号 。 这 个 格式 在 Yosemite 中 发 生 了 更 改 ; 之 前 ， 这 个 设置 是 10， 后 面 跟 着 最 大 和 最 小 
的 版 本 号 。 


(101002) 
- MAC_OS_X_VERSION_MAJOR 一 一 与 MAC_OS_X_VERSION_ACTUAL 一 样 的 6 位 数字 ， 但 是 最 后 一 位 设置 为 零 。 
(101000) 


- MAC_OS_X_VERSION_MINOR 一 一 4 位 的 数字 ， 指 定 了 当前 OS 版 本 ， 和 忽略 了 前 面 的 10。 在 Yosemite 操 作 系 统 中 ， 前 两 个 
数字 总 是 10; 后 面 两 个 是 最 低 的 版 本 。 


- MAC_OS_X PRODUCT BUILD_VERSION- 一 一 当前 OS 的 构建 数字 。 


(14Cnnn) 


- XCODE_VERSION_ACTUAL 
(0602) 
XCODE_VERSION_MAJOR (0600) , 
XCODE_VERSION_MINOR 
(0620) 一 一 它 与 MAC_OS_X_VERSION 中 设置 的 版 本 信息 相同 ， 除 了 Xcode 本 身 的 信息 。 


代码 签名 


这 些 设置 控制 着 配置 问题 ， 包 括 配 置 文 件 的 选择 和 签名 标识 。 


- AD_HOC_CODE_SIGNING_ALLOWED 一 一 控制 着 本 次 构建 是 否 使 用 Ad hoc 发 布 文件 。 


(NO) 


* CODE_SIGN_IDENTITY 





构建 使 用 的 签名 标识 。 它 可 能 使 用 简略 的 形式 ， 比 如 iPhone Developet 或 者 iPhone 
Disttibution。 如 果 使 用 了 简略 的 模式 ， 那 么 构建 系统 将 会 查阅 配置 文件 ， 寻 找 所 需 认 证 的 全 名 。 


- 如 果 可 以 避免 ， 那 么 不 要 显 式 设置 标识 ， 否 则 ， 团 队 成 员 将 会 被 迫使 用 他 们 自己 的 认证 ， 然 后 将 项 目 提交 到 源 代 码 管理 器 
中 。 其 他 团队 成 员 签 出 项 目 文件 后 会 发 现 他 们 没有 这 个 项 目 所 需 的 认证 。 这 将 会 导致 开发 成 员 之 间 的 竞争 ， 看 谁 先 将 自己 的 认证 
添加 到 通用 的 项 目 文件 中 。 


. 使 用 通用 的 身份 。Xcode 能 够 区 分 ， 如 果 Xcode 无 法 区 分 ， 那 么 你 就 会 遇 到 一 个 配置 问题 ， 当 你 开始 构建 发 布 版 本 的 时 候 


(iPhone Developer) 
-CODE_SIGNINE_ALLOWED 一 一 标识 是 否 要 执行 代码 签名 步骤 。 在 考虑 tfequifed 之 前 必须 要 先 将 allowed 设 置 为 YES。 


(NO) 





- CODE_SIGN_ENTITLEMENTS——.entitlements blist 的 路 径 ， 里 面 声 明了 使 用 特定 服务 的 权限 ， 它 与 项 目 文件 夹 有 关 。 


(Passer Rating Target/Passer Rating.entitlements ) 





- CODE. SIGN RESOURCE, RULES. PATH 指向 一 个 属性 列表 的 路 径 ， 这 个 属性 列表 中 包含 了 在 产品 、 包 中 执行 


codesign 操 作 要 忽略 的 文件 名 ， 所 以 在 签名 之 后 ， 这 些 文件 不 会 被 锁定 还 能 修改 。 


OTHER_CODE_SIGN_FLAGS 一 一 标识 任何 需要 传 入 codesign 中 的 额外 命令 行 参数 。 通 常 你 不 会 更 改 Xcode 用 于 Developet 


ID 或 者 Mac 应 用 商店 的 OS 或 者 Mac 构 建 参 数 。 


- PROVISIONING_PROFILE 一 一 它 是 与 Info.plist 中 的 bundle ID 相 匹配 的 正确 配置 文件 的 UUID。 新 target 不 会 设置 它 ; Xcode 
会 根据 application ID 和 你 选择 的 签名 认证 找到 正确 的 配置 文件 。 独 立 设置 配置 文件 没有 意义 ， 因 为 除了 匹配 的 配置 文件 以 外 ， 其 
他 文件 都 是 错误 的 。 


原 代 码 位 置 


PROJECT_DIR 一 一 包含 项 目 文件 的 目录 。 


(/Users/fritza/Desktop/PasserRating) 





PROJECT _FILE_PATH-- 一 项 目 文 件 的 完整 目录 。 


(/Users/fritza/Desktop/PasserRating/PasserRating.xcodeproj ) 


- SDKROOT 一 一 搜索 系统 头 文 件 和 目录 的 根 目 录 。 它 与 OSXSDKSs 相 似 ， 不 过 它 更 多 的 是 涉及 iDOS SDK 中 的 平台 和 OS 选 
项 。 它 的 值 应 该 与 DK_DIR 一 致 ， 最 后 一 个 组 件 应 该 与 DK_NAME 中 的 基本 名 一 样 。 
(/Applications/ Xcode.app/http://www.hzcourse.com/tresource/readBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.../iPhoneSimulator8.2.sdk) 
- SRCROOT 一 一 包含 项 目 源 代码 的 文件 夹 路 径 ， 通 常 是 项 目 文档 的 目录 SOURCE_ROOT 是 它 的 同义词 。 


(/Users/fritza/ Desktop/PasserRating) 


生成 位 置 


这 些 目录 是 构建 过 程 中 对 象 文件 ， 派 生 文件 和 构建 生成 的 产品 指向 的 目录 。 这 里 面 很 多 路 径 都 是 项 目的 derived-data (ik 
生 数 据 ) 的 目录 。 你 可 以 在 Build 选 项 卡 中 使 用 File 一 Project(or Workspace)Settings 命 令 设置 这 个 目录 ， 但 是 通 党 需要 使 用 加 
认 目 录 ， 默 认 目 录 处 于 主 目录 下 的 Library 文 件 夹 。 默 认 目 录 的 路 径 很 深 ， 而 且 路 径 名 称 中 包含 特定 的 标识 字符 串 ， 所 以 我 无 法 
将 它 在 这 里 列 出 来 ， 你 可 以 通过 文件 夹 名 字 前 面部 分 与 你 的 target 名 称 相 对 比 ， 从 而 分 辨 出 这 个 目录 。 如 果 你 看 到 一 个 路 径 的 名 
字 由 /Users/fritza/Library 开 涉 ， 那 么 就 可 以 认为 它 是 派生 数据 目录 。 


派生 数据 目录 的 意义 在 于 将 Xcode 在 项 目 构建 和 管理 过 程 中 生成 的 所 有 文件 (BRS, UMAGA) 放 在 同一 个 位 置 。 这 
些 “派生” 文件 包含 来 自 于 源 文件 和 设置 中 的 信息 ， 它 们 可 以 根据 项 目 内 容重 新 构建 而 成 。 如 果 你 想 要 共享 项 目 目 录 或 者 将 项 目 
目录 放 到 版 本 仓库 中 ， 你 肯定 不 想 将 这 些 派生 文件 也 纳入 共享 目录 或 者 版 本 控制 仓库 。 如 果 必 须要 将 派生 数据 目录 放 到 项 目 文件 
夹 中 ， 那 么 请 确保 给 这 个 派生 目录 指定 一 个 特定 的 文件 名 ， 让 它 能 够 与 Subversion 或 者 Git 配 置 文件 中 的 忽略 文件 匹配 模式 相 匹 
Bc. 


如 果 你 想 要 查看 派生 数据 的 文件 夹 ， 请 打开 Organizer (Window—Organizer) ， 然 后 选择 Projects 面 板 。 在 列表 的 左 侧 
找到 你 的 项 目 ， 然 后 查看 细节 视图 顶部 的 面板 。 文 件 夹 的 完整 目录 将 会 显示 出 来 (如果 窗口 过 小 会 从 中 间 截 断 ) 。 旁 边 是 一 个 小 
箭头 按钮 ， 能 在 Finder 中 找到 对 应 的 目录 。 


- OBJROOT 





这 个 文件 天 会 包含 一 些 中 间 产 物 ， 比 如 构建 过 程 中 生成 的 对 象 文件 。 除 非 你 为 中 间 文件 重 写 生成 路 径 ， 否 
则 这 个 文件 夹 将 会 存在 于 Library 目 录 的 深 处 。 (/Users/fritza/Library/Developet/ Xcode/DerivedData/ /Passer Rating- 
http://www.hzcourse.com/resource/readBook? 


path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.../Intermediates ) 


- SYMROOT 





这 个 文件 夹 中 都 是 那些 还 没有 去 除 符 号 的 产品 。 这 个 文件 夹 也 在 Library 目 录 中 。 


(/Users/fritza/Library /Developer/-http://www.hzcourtse.com/resoutce/readBook? 


path= /openresoutces/teach_ebook/uncomptessed/15555/OEBPS/Text/.../ArchiveIntermediates//Passer Rating/-BuildProductsPath) 


- DSTROOT 





这 是 产品 的 “安装 ”目录 。 对 于 iOS tatget 来 说 ， 它 只 是 一 个 简单 的 保存 文件 的 目录 。 对 于 OS XR, Cid 


常 处 于 /tmp 树 中 ， 同 时 项 目 会 将 子 目 录放 在 DSTROOT 中 ， 就 像 它 是 你 的 文件 系统 的 根 目录 。 它 仅 与 install 构 建 相关 。 现 在 ， 仅 
有 在 你 构建 和 测试 系统 或 者 内 核 软件 的 时 候 才 有 用 。 


(/tmp/Passer Rating.dst) 


-BUILT PRODUCTS_DIR 一 一 存放 项 目 生 成 的 每 个 产品 的 目录 的 完整 路 径 ， 或 者 如 果 产 品 是 分 散 的 ， 那 么 存放 的 就 是 每 个 
“ 品 的 符号 链接 。 因 此 脚本 可 以 通过 这 个 路 径 访 问 到 所 有 的 产品 。 默 认 情 况 下 ， 路 径 为 $SYMROOT)AWCONFIGURATION ， 它 
在 Library 目 录 的 深 处 。CONFIGURATION_BUILD_DIR 是 它 的 同义词 。 (/Users/fritza/Libraty/Developer/- 
Xcode/DerivedData/ Passer Rating-http://www.hzcourse.com/resoutce/teadBook? 


path=/openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.../Build/Products/Debug-iphonesimulatotr) 


-TARGET _ BUILD_DIR 一 一 当前 tatget 的 构建 目录 。 (/Users/fritza/Libratry/Developet/-Xcode/DerivedData/Passer Rating- 
http://www.hzcourse.com/resource/readBook? 


path= /openresoutces/teach_ebook/uncomptessed/15555/OEBPS/Text/.../Build/Products /Debug-iphonesimulator ) 


DERIVED_FILE_DIR 一 一 存放 构建 过 程 中 生成 的 中 间 文 件 的 路 径 ， 比 如 由 bison 分 析 生 成 器 产生 的 源 文 件 。 这 个 变量 与 
DERIVED_FILES_DIR 和 DERIVED_SOURCES_DIR 平 齐 。 如 果 你 有 一 个 需要 存放 临时 文件 的 需求 ， 那 么 就 参考 下 Xcode 文 档 中 
89 PROJECT_TEMP_DIR&#TARGET_TEMP_DIR. 

(/Usets/fritza/Library /Developer/http://www.hzcourse.com/resoutce/teadBook? 
path= /openresourtces/teach_ebook/uncompressed/15555/OEBPS/Text/.../Build/Intermediates/Passer Rating. build/Debug- 


iphonesimulator/Passer Rating. build/DerivedSoutces ) 


.OBJECT_FILE_DIR 一 一 包含 子 目录 的 文件 夹 ， 每 个 子 目 录 对 应 一 种 处 理 器 架构 ， 包 含 这 种 处 理 器 下 编译 后 的 对 象 文件 。 
它 在 派生 数据 文件 夹 中 ， 默 认 情 况 下 在 Library 文 件 夹 的 深 处 。 


(/Usets/fritza/Library /Developer/http://www.hzcoutse.com/resoutce/teadBook? 
path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/.../Build/Intermediates/Passer Rating Target.build/Debug- 


iphonesimulator/Passer Rating. build) 


如 果 这 个 选项 设置 为 NO ， 那 么 构建 系统 就 会 采取 各 种 措施 将 构建 产品 发 布 到 最 终 的 目录 。 实 际 上 ， 


并 没有 实际 安装 ; “人 安装” 树 由 Xcode 文 档 包 限制 。 导 出 文档 将 会 把 树 和 你 选择 的 根 路 径 合 并 。 


- SKIP_INSTALL 





` 如 果 你 想 创 建 一 个 独立 的 框架 ， 那 么 必须 将 SKIPINSTALL 设 置 为 NO， 否 则 这 个 框架 将 会 仅仅 作为 继承 产品 目录 中 部 分 构 


建 的 临时 产品 ， 用 于 开发 中 的 其 他 产品 。 


(NO) 


Bundle Locations 


- 如 果 产 品 是 一 个 bundle， 比 如 说 应 用 程序 或 者 一 个 框架 ， 那 么 WRAPPER_NAME 就 是 bundle 目 录 的 名 字 。 


(Passet Rating) 





- WRAPPER_EXTENSION 和 WRAPPER_SUFFIX 
号 的 bundle 目 隶 的 扩展 名 。 





k 





如 果 tareet 是 一 个 bundle， 那 么 这 两 个 变量 分 别 指 的 是 扩展 名 和 带 有 去 


(app and.app) 


- 如 果 SHALLOW_BUNDLE 的 值 是 YES， 那 么 本 节 其 他 的 设置 都 无 效 ， 因 为 产品 bundle 就 像 一 个 iDOS 应 用 程序 一 一 除了 本 地 
化 外 的 所 有 文件 ， 都 可 以 迅速 在 bundle 目 录 中 找到 ， 而 不 带 有 OS X bundle 2474). 


(YES) 





这 个 路 径 在 target 构 建 目录 中 ， 包含 一 个 bundle 产 品 的 结构 化 目录 。 


(Passer Rating.app) 


- EXECUTABLE_FOLDER_PATH 一 一 在 target 构 建 目录 的 bundle target 中 ， 是 构建 产品 执行 文件 的 生成 目录 。 不 要 将 它 与 
EXECUTABLES_FOLDER_PATH 相 混淆 ， 这 个 变量 指向 的 是 “附加 的 二 进 制 文件 目录， 名 为 Executables。 


(Passer Rating.app) 


* EXECUATABLE_PATH 





它 在 TARGET_BUILD_DIR 中 ， 可 执行 二 进 制 文件 的 路 径 。 
( Passer Rating.app/ Passer Rating) 


* FRAMEWORKS_FOLDER_PATH 





它 处 于 target 构 建 目录 中 的 一 个 bundle target 中 ， 这 个 路 径 包 含 用 于 产品 使 用 的 框架 
在 iOS 构 建 中 会 设置 这 个 变量 ， 即 使 在 iOS 应 用 程序 中 并 不 包含 框架 。 对 于 MyMacApp.app 来 说 ， 它 可 能 是 
MyMacApp.app/Contents/Framewofrks。 对 于 其 他 可 能 的 bundle 目 录 来 说 还 有 一 些 变量 ， 详 情 见 Xcode 文 档 。 


(Passer Rating.app/Frameworks ) 











这 个 目录 处 于 target 构 建 目录 中 的 一 个 bundle 产 品 中 ， 这 个 构建 目录 包 
带 本 地 化 信息 的 资源 文件 一 一 甚至 连 基 本 的 本 地 化 信息 都 没有 。 对 于 MyMacApp.app 来 说 ， 这 个 目录 应 该 是 
MyMacApp.app/Contents/Resources o 


(Passer Rating.app) 
编译 器 设置 


这 些 设置 控制 着 构建 系统 如 何 生 成 可 执行 代码 。 很 多 参数 都 是 以 CLANG 或 者 GCC 开 涉 ,虽然 gcc 已 经 不 在 Apple 的 开发 者 
工具 中 了 ， 取 而 代 之 的 是 clang 编 译 器 。 之 所 以 还 以 GCC 开 头 ， BAS AERA. 


中 注意 虽然 构建 变量 暴露 了 很 多 clang 设 置 ， 但 是 要 记 住 : 脚本 对 这 些 变量 仅 有 只 读 访 问 的 权限 。 在 脚本 之 中 做 的 任何 更 

改 外 面 都 看 不 到 。GCC_ 和 CLANG._ 变量 主要 用 于 其 他 构建 设置 的 替换 ， 包 含 那 些 可 能 是 你 自己 的 创建 的 构建 变量 。 比 如 ， 你 可 

能 将 一 个 设置 字符 串 赋 值 给 GCC_PREPROCESSOR_DEFINITIONS 预 处 理 器 变量 ， 所 以 你 就 能 体验 编译 器 设置 并 语序 代码 直接 
打印 构建 设置 。 


- ARCHS 





Xcode 用 来 生成 产品 代码 的 CPU 架构 。 选 项 必须 来 自 于 VALID_ARCHS 列 表 。 默 认 情 况 下 ， 它 的 值 是 
ARCHS_STANDARD。 ( 见 第 25 章 ， 构建 系统 如 何 处 理 多 架构 的 产品 ) 。 注 意 模 拟 器 上 运行 的 iDS app 实 际 使 用 的 是 Mac 的 硬件 ， 


所 以 这 个 字符 串 将 会 打印 Intel 处 理 器 。 


(x86_64) 





它 是 Xcode 构建 的 默认 架构 设置 。 


(1386 x86_64) 


- ARCHS_STANDARD_32_BIT(386) , 


- ARCHS_STANDARD_64_BIT(x86_64) fe 


. ARCHS_STANDARD. 32_64_BIT(i386 x86_64) 





如 果 你 专门 想 要 指出 target 应 该 是 64 位 、32 位 ， 或 者 同时 针对 两 者 的 话 ， 
你 应 该 使 用 这 个 标准 架构 替代 ARCHS_STANDARD。 


. NATIVE_ARCH 一 一 当前 构建 使 用 的 架构 。 它 与 CURRENT_ARCH 和 NATIVE_ARCH_ACTUAL (如 果 目 标 是 OSX) 一 
Run Sctipt 构 建 阶段 在 每 次 构建 的 时 候 只 会 运行 一 次 ， 所 以 
CURRENT_ARCH 的 值 将 会 是 实际 构建 时 候 使 用 的 架构 之 一 。 如 果 你 的 脚本 必须 要 满足 每 种 架构 ， 那 么 需要 枚 举 ARCHS。 


样 。 注 意 你 无 法 在 脚本 中 真正 使 用 CURRENT_ARCH 





(1386) 


* NATIVE_ARCH_ 32_BIT 和 和 NATIVE_ARCH_64_BIT 


在 iOS 构 建 中 ， 这 些 设置 没有 实际 意义 





和 NATIVE_ARCH 类 似 ， 但 是 指向 开发 架构 的 32 位 和 64 位 变量 。 
它们 对 应 各 自 的 Intel 架 构 。 





(i386 和 x86_64) 
- CLANG_CXX_LANGUAGE_STANDARD 一 一 C++clang 能 接受 的 同系 语言 。 


(onu++0x) 





- CLANG_ENABLE_MODULES 
是 使 用 模块 。 


指定 C 家 族 语言 是 否 应 该 接受 (@module 指 令 ， 也 就 是 是 否 应 该 编译 为 模块 。Swift 代 码 总 





- DEFINES MODULE 构建 生成 的 代码 是 否 会 组 成 一 个 模块 。 
(NO) 


- MODULE_NAME 一 一 生成 代码 定义 的 模块 名 称 。 





( 空 没有 定义 模块 ) 


- PRODUCT MODULE NAME 一 一 排序 用 的 生成 代码 模块 的 名 称 。 现 在 它 很 重要 ， 因 为 API 和 Swift 代码 都 是 按照 模块 的 命 


名 空间 分 隔 。 


(Passer_Ratin g) 





- CLANG ENABLE OBJC ARC clang 是 否 应 该 针对 Objective-C 代 码 生 成 Automatic Reference Counting 代 码 ， 加 强 ARC 的 


(YES ) 


- GCC OPTIMIZATION LEVEL 





clang 为 了 生成 更 有 效率 的 代码 使 用 的 策略 。 可 能 的 值 包 括 -O0 字 面 上 的 转换 ， 最 适宜 调 
A; -O3 最 高 优化 选项 ， 仍 然 维持 着 标准 的 兼容 性 ; -Ofast，“ 侵 略 性 的 ”， 和 追逐 速度 而 牺牲 了 遵循 的 标准 ， 因 为 其 他 方法 生成 
了 更 多 的 代码 ， 有 可 能 会 让 处 理 器 的 代码 缓存 过 载 ， 需 要 停 下 来 等 待 从 内 存 中 载 入 。 


- SWIFT OPTIMIZATION_LEVEI 一 一 Swift 的 优化 策略 。 级 别 分 为 -Ohone， 没 有 优化 ， 最 适合 调试 ; -DO ， 为 了 维护 运行 时 
一 致 性 的 检查 ; -Ounchecked， 移 除 所 有 的 一 致 性 检查 。 只 有 在 你 已 经 尝试 了 各 种 方法 都 无 法 触发 -Onone 代 码 中 的 检查 ， 然 后 才 
能 发 布 一 个 -Ounchecked 产 品 。 


(-Onone) 


-GCC_VERSION 和 GCC_VERSION_IDENTIFIER 一 一 是 当前 使 用 的 编译 器 版 本 ，Apple 上 固定 为 clang1.0， 到 现在 为 止 还 没 
有 向 后 兼容 的 问题 。 这 两 者 之 间 的 差别 在 于 标识 符 使 用 下 划 线 而 不 是 运 号 。 


(com.apple.compilers.llvm.clang. 1_0) 


- GCC_PREPROCESSOR_DEFINITIONS 一 一 是 一 个 由 空格 分 隔 的 列表 ， 列 表 中 定义 了 所 有 编译 的 符号 。 条 目的 形式 是 
symbol=value ， 将 值 赋 给 符号 。 用 这 种 方式 定义 的 符号 将 会 与 预 编译 的 头 文 件 结合 在 一 起 。 与 之 相关 的 是 
PREPROCESSOR_DEFINITIONS_NOT_USED _IN_PRECOMPS， 它 指定 了 在 每 次 编译 中 定义 的 符号 ,但 是 不 包含 预 编译 头 文 
件 。 它 允许 你 在 构建 配置 间 共 享 预 编译 头 文 件 ， 全 局 定义 的 变量 作为 各 个 配置 中 的 选项 。 


Swift 将 会 通过 预 处 理 指 令 接 受 预 处 理 符 号 做 测试 ， 比 如 #if。 这 个 指令 仅仅 会 接 膏 简单 值 ， 它 们 不 会 像 C 家 族 的 语言 那样 展 
开 宏 。 如 果 想 要 定义 它们 ， 在 OTHER_SWIFT_FLAGS 中 添加 -D symbol. 





- GCC_ENABLE_OBJC_GC 一 一 它 控 制 项 目 编译 Objective-C 源 代码 的 时 候 是 否 支持 垃圾 回收 。Build Settings 编 辑 器 中 已 经 不 


再 使 用 这 个 设置 ， 因 为 Apple 在 所 有 的 开发 中 都 禁止 使 用 垃圾 收集 


` 若 构 建 的 过 程 中 出 现 仅 出 现 警 告 而 没有 错误 ， 也 将 这 次 构建 视 为 构建 失败 是 一 个 好 的 做 法 。 因 为 在 有 警告 存在 的 情况 下 ， 
即使 生成 了 可 执行 的 二 进 制 文 件 ， 它 也 有 可 能 无 法 正常 运行 。GCC_TREAT _ WARNING AS_ERROS 上 默认 情况 下 没有 启动 这 个 功 
能 ， 但 是 可 能 应 该 将 它 设置 为 默认 值 。 在 大 多 数 情 况 下 ， 警 告 会 指出 你 可 能 需要 调试 的 记 辑 错误 。 


(NO) 


- GCC_ WARN_INHIBIT_ALL WARNING 一 一 它 与 GCC_TREAT_WARNING_AS_ERROS 相 反 。 设 置 了 这 个 值 之 后 ，clang 不 
会 报 出 任何 警告 错误 。 如 果 你 喜欢 这 么 做 ， 那 么 请 让 你 的 客户 明晰 这 一 


- OTHER_CFLAGS , OTHER_CPLUSPLUSFLAGS 以 及 OTHER_ 





编译 器 选项 的 综合 变量 ， 用 于 那些 没有 


专门 针对 C 或 者 Swift 编译 器 的 构建 变量 。OTHER_SWTIEFT_FLAGS 是 唯一 可 以 为 Swift 代码 设置 预 编 译 符 号 的 方法 。 


- Apple 正 在 尝试 在 Build Settings 选 项 卡 中 合并 每 个 合理 的 标识 ， 所 以 你 应 该 很 少 需要 使 用 这 个 设置 。 在 设置 选项 卡 的 搜索 栏 
中 直接 输入 一 个 标识 的 名 称 ， 查 看 是 否 有 直接 可 以 使 用 的 变量 是 一 个 好 想法 。 对 于 链接 标识 来 说 ， 与 之 相对 应 的 是 
OTHER_LDFLAGS. 





(Z) 


- GCC_WARN_http://www.hzcourse.com/resource/readBook? 





path= /openresources/teach_ebook/uncompressed/15555/OEBPS/Text/... clang 接 受 很 多 警告 标识 ， 其 中 大 多 数 在 构建 变量 中 都 
有 与 之 等 价 的 变量 。 在 Build Settings 选 项 卡 中 使 用 Quick Help 查 看 器 ( 右 侧 Utility 区 域 第 二 个 选项 卡 ) 查看 警告 的 作用 以 及 构建 变 


量 的 等 价 物 是 什么 


很 多 开发 者 使 用 -Wall 作为 警告 综合 设置 的 快捷 方法 ， 同 时 clang 开 发 者 提供 了 其 至 提供 了 更 为 严格 的 -Wevetything， 他 们 很 
多 坚持 调试 编译 器 。Build Settings 选 项 卡 并 没有 暴露 这 些 选 项 ， 所 以 如 果 需 要 请 将 它们 放 在 OTHER_CFLAGS 中 。 


- EMBEDDED_CONTENT_CONTAINS_SWIFT 





如 果 你 的 tatget 在 主 代码 中 主要 使 用 Swift， 那 么 构建 系统 知道 要 包含 
Swift 运行 时 库 用 于 OS 义 10.9 和 iOS 7 的 兼容 性 。 系 统 无 法 再 插件 和 帮助 App 中 检测 到 Swift 代码 ; 如 果 你 的 App 包 含 这 样 的 代码 ， 
请 将 它们 设置 为 YES 为 它们 添加 运行 时 。 


其 他 工具 
融 像 你 在 第 25 章 中 看 到 的 那样 ， 编 译 器 不 是 唯一 的 构建 工具 。 下 面 还 有 一 些 设置 用 于 其 他 工具 。 
Asset Catalog Compiler 
.Xxcassets 目 录 下 的 图 片 必须 处 理 成 为 更 加 紧凑 的 格式 ，Info.plist 必 须 添加 一 些 设置 确定 应 用 程序 的 图 标 和 启动 图 片 。 
- ASSETCATALOG_COMPILER_APPICON_NAME 一 一 包含 应 用 程序 图 标的 图 片 集合 。 
(Applcon) 
- ASSETCATALOG_COMPILER_LAUNCHIMAGE_NAME——4 J A H #449 % #. 
(LaunchImage) 
- COMPRESS_PNG_FILES 一 一 在 PNG 图 片 添加 到 产品 包 中 的 时 候 是 否 要 压缩 。 


(YES ) 


Info.plist 


项 目 中 的 Info.plist 文 件 仅仅 是 出 现在 最 终 包 中 的 Info.plist 文 件 的 源 文 件 。 构 建 过程 中 包含 解析 构建 设置 引用 的 一 个 步骤 ， 
插入 强制 性 的 键 值 ， 同 时 可 以 选择 是 否 应 用 C 风 格 的 处 理 器 。 


- INFOPLIST_FILE 





如 果 这 个 tatget 的 产品 是 一 个 bundqle， 那 么 它 应 是 用 于 生成 bundle 的 Info.plist 文 件 的 源 文件 的 名 字 。 当 


一 个 项 目 有 多 个 target 的 时 候 ， 需 要 指定 多 个 Info.plist 文 件 ， 而 不 能 仅 使 用 Info.plist。 
(Info.plist) 


. do 25% F AYES, INFOPLIST PREPROCESS 预 处 理 INFEOPLIST _FIIE 的 时 候 会 使 用 C 风 格 的 预 处 理 器 。 你 可 以 使 用 


INFOPLIST_PREFIX_HEADER 指 定 一 个 前 级 文件 ， 并 使 用 INFOPLIST_PREPROCESSOR_DEFINITIONS 设 置 符号 。 


INFOPLIST_EXPAND_BUILD_SETTINGS 一 一 控制 构建 设置 是 否 应 该 在 生成 的 Info.plist 文 件 中 展开 。 比 如 ， 它 允许 你 使 


用 ${EXECUTABLE_NAME} 填 充 CFBundleExecutable， 同 时 确保 ， 如 果 你 想 要 更 改 产 品 的 名 字 ，Info.plist 将 总 是 会 同步 更 新 。 
(YES) 


- INFOPLIST_OUT_FORMAT 





这 个 选项 可 以 让 你 选择 Info.plist 属 性 列表 文件 的 文件 格式 。 如 果 想 要 使 用 二 进 制 格 式 ， 就 
设置 为 binarty， 其 他 任何 选项 都 会 生成 XML 格式 的 Plist 文 件 。 


(binaty ) 





-INFOSTRINGS_PATH 一 一 这 个 路 径 由 应 用 程序 包 开 头 ， 指 向 开发 区 域 的 InfoPlist.sttings 文 件 。 开 发 地 域 由 


DEVELOPMENT LANGUAGE 指 定 。 
(Passer Rating.app/English.lproj/InfoPlist.strings) 


:CREATE _INFEOPLIST _ SECTION_IN_BINARY 一 一 部 分 单个 文件 的 产品 ， 比 如 独立 的 库 和 命令 行 工 具 ， 必 须 包 含 Launch 


Setvices 和 Findet 人 信息。 它们 没有 独立 的 Info.plist 文 件 ， 所 以 选项 会 添加 Mach-O 〇 二进制 部 分 用 于 Info.plist 数 据 。 


(NO) 


- STRING_FILE_OUTPUT_ENCODING—— strings 4 KHA SER (通常 是 英语 名 ) 映射 到 在 特定 语言 中 展示 的 字符 


串 。 ( 见 第 21 章 ) 它 是 经 过 编码 处 理 的 字符 串 ， 之 前 使 用 的 是 UTF-16， 但 是 现在 有 一 种 二 进 制 格式 ，Cocoa 能 更 有 效率 的 使 用 。 


(binary) 


Java 


Apple 大 约 在 2002 年 前 后 不 再 使 用 Java 作 为 OS XF ABS (Java 那 时 候 还 是 个 不 错 的 想法 ) 。 还 有 很 多 Java 相 天 的 设置 ， 
大 多 数 都 以 JAVA 为 前 缀 。Xcode 没 有 暴露 它们 。 它 们 不 会 做 任何 事 。 所 以 可 以 忽略 它们 。 


其 他 


部 分 变量 指向 了 标准 的 UNIX 工 具 。 通 常会 在 Xcode.app 包 内 部 找到 开 友 工具 ; 剩 下 的 标准 UNIX 命 令 行 工 具 可 以 在 /bin、 
/usr/bin、/sbin 或 者 /usr/sbin 目 录 树 中 找到 。 大 多 数 Make-like 系 统 会 通过 这 种 方法 获取 工具 名 称 ， 所 以 切换 到 自 定义 工具 只 
不 过 是 修改 时 个 定义 。 


指针 变量 (指向 它们 的 工具 应 该 对 任何 需要 它们 的 人 来 说 都 很 明显 ) 包括 CHOWN、CHMOD、CP、ICONV、LEX、SED 
和 YACC。 


有 4 个 命令 用 于 REMOVE something FROM RESOURCES 这 种 形式 的 定义 。YES/NO 开 关 决 定 了 是 否 使 用 版 本 管理 目录 ， 
当 复 制 文件 到 产品 bundle 的 时 候 是 否 应 该 忽略 头 文件 。 


搜索 路 径 


- HEADER_SEARCH_PATHS 它 是 一 个 空格 分 隔 的 路 径 列 表 ， 用 于 编译 器 查找 头 文件 ， 还 包括 标准 路 径 ， 比 
如 /ust/include。 如 果 你 添加 自己 的 路 径 ， 那 么 请 在 列表 的 开头 或 者 结尾 添加 $(inherited) 继 承 默认 路 径 。 如 果 有 疑问 的 关 文 件 处 于 
框架 中 ， 那 么 就 需要 设置 FRAMEWORK SEARCH_PATHS 替 代 。SDKROOT 用 于 系统 头 文件 和 框架 的 路 径 。 





(/Users/fritza/Library/http://www.hzcoutse.com/resoutce/readBook? 
path= /openresourtces/teach_ebook/uncompressed/15555/OEBPS/Text/...Build/Products/Debug- 
iphonesimulator/include/ Applications /Xcode.app/http://www.hzcoutse.com/resoutce/teadBook? 


path= /openresoutces/teach_ebook/uncompressed/15555/OEBPS/Text/.../ust/include ) 


- LIBRARY_SEARCH_PATHS 





空格 分 隔 的 路 径 列 表 ， 用 于 连接 器 搜索 库 文 件 。 如 果 设 置 了 这 个 值 ，SDKEROOT 将 会 指 
向 系统 库 的 目录 。 开 发 者 有 的 时 候 会 提供 生产 或 者 调试 形式 的 库 文件 ， 它 们 都 是 不 带 源 代 码 的 二 进 制 文件 。 开 发 者 可 能 会 在 
Debug 构 建 的 时 候 使 用 一 种 版 本 ， 而 在 Release 构 建 的 时 候 ， 使 用 另外 一 种 版 本 。 解 决 方案 就 是 将 两 个 版 本 的 库 文件 放 到 单独 的 目 
录 中 ， 然 后 为 不 同 的 构建 配置 指定 不 同 的 LIBRARY_SEARCH_PATHL。 


(/Users/fritza/Library/http://www.hzcoutse.com/resoutce/readBook? 


path= /openresoutces/teach_ebook/uncompressed/15555/OEBPS/Text/...Build/Products /Debug-iphonesimulator) 


- IPHONEOS_DEPLOYMENT TARGET 一 一 产品 可 以 运行 的 最 低 iOS 版 本 。 来 自 于 OS 后 面 版 本 SD 区 的 符号 都 是 弱 链 接 。 


还 有 一 个 MACOSX_DEPLOYMENT TARGET。 


(8.2) 


DEVELOPER 变量 


FHDEVELOPER 字符 串 开 头 的 设置 是 以 前 版 本 的 Xcode 中 经 弟 使 用 的 一 部 分 构建 变量 ， 构 建 系统 仍然 会 企 run-script build 
phases 中 使 用 它们 。 这 些 变量 都 是 只 读 的 ， 所 以 它们 不 会 在 Build Setting 选 项 卡 中 作为 默认 值 出 现 。Apple 也 没有 再 为 它们 提 
供 文档 支 持 。 之 所 以 我 会 在 这 里 介绍 它们 ， 是 为 了 让 你 没有 其 他 选择 的 时 候 尝 试 。 


很 多 以 DEVELOPER 开头 的 路 径 与 都 有 与 之 相对 应 的 以 SYSTEM_、SYSTEM _DEVELOPER 、PLATFORM 以 及 
PLATFORM_DEVELOPER 开头 的 路 径 。 因 为 工具 和 框架 集 可 能 会 因为 面向 OS X 或 者 IOS 开 发 而 有 所 不 同 。 


唯一 保存 下 来 不 变 的 变量 是 SYSTEM LIBRARY DIR, CEOS X 框 架 安装 的 根 路 径 。 


如 果 你 正在 寻找 Xcode 开 发 工具 的 路 径 ， 最 好 使 用 xcrun=-find 命 令 查找 与 当前 Xcode 相 匹配 的 路 径 ， 以 及 你 想 要 使 用 的 特定 
SDK。 参 见 man xcrun 查 看 更 多 细节 。 





- DEVELOPER DIR 它 是 Xcode 的 安装 目录 。DEVELOPER_ 变量 非常 重要 ， 因 为 如 果 安 装 了 多 个 Xcode， 那 么 它 能 记录 








当前 选择 的 Xcode。 详 情 见 man xcode-select。 


(/Applications/Xcode.app/Contents/Developer) 











- DEVELOPER_APPLICATIONS_DIR 一 一 它 是 DEVELOPER_DIR 中 的 文件 夹 ， 它 包含 Xcode 和 其 他 开发 者 应 用 程序 。 如 果 


想 要 做 的 只 是 启动 一 个 用 户 应 用 程序 ，open -aapplication-name 这 人 条 命令 非常 合适 。 
(/Applications/ Xcode.app/Contents/Developert/ Applications) 


* DEVELOPER_BIN_DIR 











它 是 DEVELOPER_DIR 中 的 文件 夹 ， 包 含 BSD 工 具 ， 比 如 Xcode 使 用 的 clang。 如 果 编 写 直 接 


执行 开发 工具 clang 或 者 yacc 的 脚本 ， 那 么 请 使 用 这 个 路 径 蔡 换 /ust/bin。 这 个 目录 下 的 工具 与 你 正在 使 用 的 Xcode 版 本 相对 应 。 
(/ Applications /Xcode.app/Contents /Developer/ustr/bin) 


* DEVELOPER_PRAMEWORKS_DIR 











这 个 文件 夹 包 含 开发 框架 ， 它 也 在 DEVELOPER_DIR 中 ， 比 如 单元 测试 。 还 有 


一 个 QUOTED 变 量 ， 你 可 以 放心 使 用 这 个 变量 ，shell 解 释 器 不 会 混 消 。 
(/Applications/ Xcode.app/Contents/Developer/Library/Frameworks) 


* DEVELOPER_LIBRARY_DIR: 
) 。 





它 是 DEVELOPER_DIR 中 的 文件 来 ， 其 中 包含 开发 者 工具 使 用 的 文件 (模板 、 插 件 








< 


(/ Applications /Xcode.app/Contents /Developer/Library ) 


- DEVELOPER_SDK_DIR 





它 是 DEVELOPER_DIR 中 的 文件 夹 ， 包 含 target 运 行 平台 上 的 软件 开发 套件 。 








(/Applications/ Xcode.app/Contents/Developer/SDKs) 


. DEVELOPER_TOOLS_DIR 一 一 包含 BSD 工 具 ， 比 如 SetFile， 它 们 专门 用 于 OS X 开 发 ， 但 不 在 /usr/bin 中 。 





(/Applications/ Xcode.app/Contents/Developer/ Tools) 








- DEVELOPER_USR_DIR 一 一 DEVELOPER_DIR 中 的 文件 来， 应 该 将 它们 应 用 于 标准 的 include、sbin，share 和 其 他 你 想 
在 /ust 根 目录 中 查找 的 前 级 。 


(/ Applications /Xcode.app/Contents /Developer/usr) 


源 代码 树 


源 代码 树 提供 了 特定 种 类 的 构建 变量 ， 它 是 一 个 指向 目录 的 路 径 或 者 已 知 结构 树 的 根 目 录 路 径 。 这 个 路 径 可 以 用 来 接收 构建 
结果 或 者 提供 访问 系统 库 或 者 头 文件 的 位 置 。 当 用 于 构建 源 代码 路 径 的 时 候 ， 源 代码 树 为 那些 不 属于 任何 项 目 目录 树 的 包 提供 了 
可 信 的 快捷 方式 。 


比如 ， 我 在 OS X 项 目 中 使 用 了 eSellerate 库 。 打 开 Preference 窗 口 ， 选 择 Locations 面 板 下 的 Source Trees 选 项 卡 ， 单 击 
+ 按钮 添加 了 一 个 条 目 ， 为 eSellerate 库 定义 了 一 个 源 代码 树 。 我 使 用 ESELLERATE_DIR 作 为 设置 的 名 字 ， 将 eSellerate 
Directory 作 为 显示 的 名 字 ， 然 后 在 路 径 栏 中 输入 了 esellerate SDK 完 整 的 根 路 径 名 。 


现在 ， 当 我 在 项 目 中 添加 了 一 个 文件 引用 的 时 候 ， 我 可 以 使 用 Utility 区 域 中 的 File 查 看 器 将 Location 设 置 为 Relative to 
eSellerate Directory。 无 论 谁 拷贝 或 者 复制 我 的 项 目 ， 只 要 它们 定义 了 ESELLERATE_DIR 源 代码 树 ， 项 目 就 会 在 复制 出 来 的 目 
录 中 找到 这 个 文件 。 我 不 用 关心 路 径 的 细节 ， 甚 至 不 用 设置 双 点 号 的 相对 目录 引用 。 


源 代码 树 是 全 局 性 的 (多 个 项 目 都 可 以 使 用 ) ， 但 是 不 同 的 用 户 需要 分 别 设置 目 己 的 源 代码 树 。 


附录 B tak 


我 尽量 让 这 本 书 介绍 的 内 容 更 全 面 些 ， 但 还 是 无 法 做 到 面面俱到 。Xcode 是 一 个 非 惠 庞大 的 系统 ， 履 盖 了 开 友 过 程 中 的 方 万 
面 面 ， 而 且 Apple 还 在 持续 不 断 地 更 新 。 进 一 步 地 说 ， 作 为 一 个 Cocoa 程 序 员 ， 你 不 仅仅 需要 学 习 使 用 这 些 工 具 ， 而 且 需 要 掌握 
更 多 相关 的 知识 。 附 录 B 中 提供 了 一 些 资 源 的 简单 介绍 ， 这 泽 资 源 能 帮助 你 进行 更 深入 的 学 习 ， 紧 跟 技 术 步 伐 。 


书籍 


在 iOS 淘 金 热 开始 之 前 ， 仪 有 几 本 关于 Cocoa 和 Xcode 的 书籍 ， 都 相当 不 错 。 现 在 ,已 经 有 很 多 书 ， 而 且 书 的 种 类 也 很 多 。 
我 选 出 了 一 些 。 


- Buck, Erik% 569 «Cocoa Design Patterns (2009) 》。 它 介绍 了 Cocoa 遵 循 一 些 基本 的 模式 ,一旦 了 解 透 彻 ， 你 的 OS 和 OS 


X 编 程 技 能 就 会 有 大 幅 提 升 。Erik BucKk 的 书 已 经 有 6 年 历史 了 ， 但 是 其 中 基本 的 知识 没有 改变 。 


- Conway, JoeRHillegass, Aaron44% # «iOS Programming:The Big Nerd Ranch Guide, fourth edition (2014) > . Aaron 
Hillegass #4) «Cocoa Programming for OS X》 ( 见 下 ) 是 为 Mac 程 序 员 编 写 的 ， 而 本 书 针 对 iOS 程 序 员 。 这 是 一 本 从 零 开 始 的 书 ， 让 


你 从 一 无 所 知 (或 者 仅 懂得 一 些 C 编 程 ) 到 学 会 一 些 高 级 技术 。 


- Hillegass，Aaton 及 teble，Adam 编 写 的 《Cocoa Programming for OS X,fourth edition (2011) > ##Claude, Juan Pablo, A 
Hillegass 5 #9 «More Cocoa Programming for OS X:The Big Nerd Ranch Guide (2013) > 。 从 第 一 版 开始 ， 它 就 是 一 本 经 典 的 书 


籍 。 这 个 系列 的 书籍 Mac 程 序 员 已 经 看 了 10 多 年 。 它 包含 良好 的 指引 ， 从 初级 到 高 级 技术 的 示例 。 强 力 推 荐 。 


- Kochan，Stephen 编 写 的 《Programming in Objective-C,sixth edition (2013) 》。 它 是 Objective-C 书 籍 的 领头 羊 ， 它 将 
Objective-C 作 为 你 的 第 一 门 编程 语言 来 介绍 ， 它 不 会 假设 你 有 任何 C 或 者 面向 对 象 开发 的 技术 基础 。Kochan 介 绍 了 Foundation 相 


架 ,， 但 只 是 简单 涉及 了 Cocoa 应 用 程序 框架 。 


. Lee，Graham 编 写 的 《Test-Driven iOS Development (2011) > > APWR, ARAMIN: Lee 的 书籍 告诉 你 如 何 做 到 这 


- Napier, Rod&Kumar, Mugunth4% 5 h9 KIOS 6 Programming Pushing the Limits:Advanced Application Development for Apple 


iPhone,iPad and iPod Touch (2012) 》。Napiet 深 入 介绍 了 从 初级 开发 者 进 阶 到 高 级 开发 者 用 到 的 技术 。 


- Neuberg，Matt 编 写 的 《Programming iOS 8:Dive Deep into Views, View Controllers,and Frameworks(2014)» o Matt Neuberg 详 细 

(800 多 页 ) 介绍 了 iOS 开 发 的 方方面面 。 很 多 人 将 它 视 为 iDS 介 绍 的 其 峰 之 作 : 其 他 书籍 引领 你 学 习 了 制作 一 款 应 用 程序 需要 的 

iOS 高 级 技术 。Neuberg 编 写 了 一 本 上 千 页 的 书 ， 因 为 他 一 步 步 地 介绍 了 制作 过 程 中 的 基本 原则 。 他 不 但 做 到 了 授 人 以 鱼 ， 还 做 到 
了 授 人 以 渔 。 


- Neuberg, Matt44 5 #9 «iOS 8 Programming Fundamentals with Swift:Xcode and Cocoa Basics (2015) > 。 这 是 一 本 很 轻薄 


(400 多 页 ) 的 书 ， 它 更 像 是 一 本 指引 教程 。 


Sadun，Etrica 编 写 的 《The Core iOS Developer’ s Cookbook,fifth edition (2014) 》。 好 像 很 多 书 的 作者 里 面 都 有 Erica， 尤 


其 是 标题 中 带 有 Cookbook 的 书籍 。 她 是 商业 领域 写作 思路 最 清晰 也 最 值得 信赖 的 作者 之 一 。 很 多 人 都 党 拜 她 写 的 OS 书籍 。 


- Sharp, Maurice; Sadun, Erica; 及 Stroueo，Rod 编 写 的 《Learning iOS Development:A Hands-on Guide to the Fundamentals of 
iOS Programming (2013) 》。 本 书 从 开发 过 程 的 起 点 开始 ， 介 绍 了 制作 一 款 能 达到 上 架 应 用 商店 的 OS App 的 过 程 中 可 能 遇 到 的 
种 种 问题 。 


Swift 相 关 的 书籍 


天 于 Swift 的 书籍 列表 很 难 写 出 来 ， 因 为 这 是 一 门 全 新 的 语言 ， 还 在 不 断 变 化 中 ， 声 称 掌 握 了 这 | 语言 的 人 还 没有 编写 相关 
的 书籍 ， 因 为 Apple 还 没 让 它 的 雇员 这 样 做 。 还 没有 人 因为 Swift 而 出 名 ， 那 些 因 为 Cocoa 相 关 技 术 出 名 的 人 写 的 都 是 一 些 像 本 


PIX Bis 
下 面 是 一 些 预定 列表 上 我 党 得 还 不 错 的 书籍 ， 为 了 尊重 作者 和 出 版 商 ， 我 只 能 简单 介绍 一 下 ， 无 法 提供 更 多 的 细 忆 。 
Kochan，Stephen 编 写 的 《Programming in Swift(Developer s Library), sixth edition (2015) > o 


- Manning，Jonathon 及 Buttfield-Addison，Paris 编 写 的 《Swift Development with Cocoa:Developing for the Mac and iOS App 


Stores (2015) > o 
- Mark, David&Nutting, Jack 445 4% «Beginning iPhone Development with Swift:Exploring the iOS SDK (2014) > à 


- Nahavandipoor, Vandad 45 49 «iOS 8 Swift Programming Cookbook:Solutions&Examples for iOS Apps (2014) » 。 





遇 到 问题 了 吗 ? 使 用 google 或 者 任何 其 他 你 喜欢 使 用 的 搜索 引 掌 查询 你 的 问题 。 之 前 可 能 已 经 有 人 间 过 了 你 提 的 问题 ， 并 
且 获 得 了 满意 的 答案 。 不 过 在 论坛 或 者 邮件 列表 中 提问 之 前 ， 最 好 先 搜索 下 是 否 有 你 想 要 找 的 答案 。Apple 的 文档 在 Web 上 、 搜 
系 引 擎 中 的 结果 要 比 Documentation 浏 览 器 中 的 好 一 些 。 如 果 你 无 法 定位 想 要 得 找 的 问题 ， 那 么 记 住 市 上 一 些 与 相关 API 有 关 
的 唯一 性 的 符号 ， 或 者 至 少 市 上 像 iD 这 样 的 字符 。 





然后 ， 若 还 没有 找到 合适 的 答案 ， 那 么 看 看 是 不 是 Cocoa API 文 档 中 已 经 介绍 过 你 想 要 问 的 问题 ， 而 你 却 踊 忽 了 没有 注意 
到 。 重 新 阅读 Apple 的 文档 。 然 后 再 提问 。 如 果 你 况 你 已 经 尽力 寻找 答案 了 ， 但 还 是 未 果 ， 那 么 人 们 很 愿意 帮助 你 ， 因 为 你 已 经 


完成 了 目 己 的 功课 ,值得 帮助 。 


论坛 
早期 的 Xcode 非常 喜欢 邮件 列表 (或 者 邮件 列表 文档 包 ) ， 甚 至 是 USENET 组 。 随 着 时 间 的 推移 ， 人 们 赵 来 越 习惯 从 云 上 获 
取 和 保存 信息 。 几 年 前 邮件 列表 上 每 天 都 有 上 和 百 条 问题 ， 现 在 可 能 连 20 条 都 不 人 到。 如 果 想 要 提问 ， 网 页 论坛 可 能 是 一 个 更 好 的 


选择 。 


` 首先 介绍 第 二 好 的 论坛 。Apple Developer Forums 应 该 是 查找 OS 义 和 iOS 问 题 的 主要 资源 。 它 们 在 iPhone OS2 发 布 之 前 就 开 
始 作 为 解决 问题 的 途径 了 ， 这 里 不 能 讨论 未 发 布 的 API。 作 为 付费 的 开发 者 成 员 ， 你 可 以 随意 探讨 非 机 窗 性 的 话题 。 (Developer 
Tools 部 分 也 对 那些 免费 注册 的 Apple 开 发 者 开放 ) 。 部 分 Apple 开 发 者 从 非 公开 论坛 开始 ， 从 来 没有 访问 过 外 面 的 邮件 列表 或 者 


Stack Overflow. 


HERR MeARAR. PPV IFT MC, ABMLARKAA. RI RARER EMA RL, PUR 
你 想 查 找 在 Apple 框 架 中 声明 的 一 个 符号 ， 搜 索引 擎 可 能 会 为 你 显示 一 些 关 于 兽药 的 术语 。 可 以 根据 时 间 缩 小 搜索 结果 ， 但 是 你 
无 法 回 到 12 个 月 前 的 结果 (除非 你 在 新 年 夜里 执行 搜索 ) ， 因 为 搜索 引擎 只 提供 了 日 历 (calendar) 年 。 


` 搜索 引擎 按照 交互 量 对 结果 进行 排序 一 一 解决 方案 通常 会 排 在 最 前 面 。 但 Apple 的 论坛 不 是 这 样 。 当 你 输入 搜索 内 容 的 时 
候 ， 一 些 令 人 激动 的 结果 可 能 会 在 Web2.0 的 弹出 窗 只 中 一 闪 而 过 ， 但 是 当 它 停 下 来 的 时 候 ， 你 得 到 的 只 是 其 他 运气 不 好 的 人 的 
单条 消息 。 


` 但 是 如 果 你 查找 NDA 软 件 的 解决 方案 ，Apple Developer Forum 是 唯一 能 找到 答案 的 地 方 Http://devforums.apple.com/。 


还 有 一 个 更 好 的 地 方 ; Stack Overflow, ，http://stackovetflow.com/。 它 也 对 搜索 引擎 开放 ， 帖 子 中 包含 有 用 的 元 信息 。 每 个 
帖子 后 面 基 本 都 能 找到 一 个 高 质量 的 回答 (虽然 有 的 时 候 需 要 点 技巧 确定 哪个 是 最 好 的 答案 ) 。 里 面 很 少 有 闲聊 ， 基 本 都 是 问题 
的 解决 方案 。 如 果 想 要 解决 问题 ， 而 不 单单 是 获得 参考 人 信息， 那么 在 搜索 问题 的 前 面 添加 sit:stackovetflow.com。 


邮件 刘表 


Apple 有 针对 它 的 产品 开 上 友 各 个 方面 的 各 种 列表 。 完 整 的 化 名 册 在 这 个 位 
置 : http://www.lists.apple.com/mailman/ylistinfo。 记 住 ， 所 有 的 技术 邮件 列表 都 限制 为 特定 的 问题 和 解决 方案 。Apple 工 程 
师 会 在 闲暇 的 时 候 阅 读 邮 件 列 表 ， 他 们 没有 被 要 求 一 定 要 回答 帖子 中 的 问题 ;他 们 也 无 法 接受 bug 反 馈 和 功能 请 求 。 请 在 这 里 提 
出 相关 的 问题 : http://bugreport.apple.com/, 


下 面 3 个 邮件 列表 可 能 会 对 你 有 上 所 帮助 : 





履 盖 了 Xcode 和 其 他 Apple 开 发 者 工具 。 它 并 没有 处 理 程序 问题 ; 如果 你 想 要 询问 使 用 Xcode 做 什么 而 不 是 
如 何 使 用 它 ， 那 么 请 在 cocoa-dev 中 提问 。 


- xcode-users 


http://www.lists.apple.com/mailman/listinfo/xcode-users/ 





- cocoa— dev 这 里 是 关于 Cocoa 框 架 的 问题 ， 既 包含 ODS XE BANOS. 


http://www.lists.apple.com/mailman/listinfo/cocoa-dev/ 





- objc-language 处 理 Objective-C 编 程 语言 的 问题 。 关 于 Cocoa 编 程 的 问题 (除了 Foundation 中 主要 的 数据 类 型 ) 不 在 这 


http://www.lists.apple.com/mailman/listinfo/objc-language/ 


现在 还 没有 特别 满意 的 Swift 邮件 列表 ; 可 能 永远 也 不 会 有 了 。Swift-language Googles 
组 https://groups.google.comy/forum/#lforumy/swift-language， 一 天 仅 有 一 个 发 帖 量 。9Swift 问 题 也 会 出 现在 xcode-users 
和 objc-language 中 。 


Developer Technical Support 


还 有 一 个 资源 就 是 开发 者 计划 本 身 。 作 为 99$ 的 开发 者 计划 的 一 部 分 ， 你 有 两 次 获得 Apple Developer Technical 
Support (DTS) 的 机 会 (你 可 以 获得 额外 5 次 或 者 10 次 机 会 ， 大 约 每 次 机 会 要 50$) 。 如 果 你 有 一 个 非常 重要 的 问题 需要 立刻 
解决 ， 论 坛 和 邮件 列表 并 不 是 一 个 很 好 的 解决 方案 。 知 道 答案 的 人 们 并 不 一 定 在 这 里 等 着 ， 而 且 也 不 能 要 求 他 们 必须 回答 你 的 问 
题 ， 同 时 时 间 也 不 允许 你 搜索 问题 的 解决 方案 。 


如 果 填 了 一 个 DTS 事 件 请 求 ， 你 将 会 被 指定 一 个 在 3 天 内 给 出 回复 的 工程 师 。 他 将 会 访问 OS 源 代码 并 询问 编写 相关 功能 的 工 
程 师 。 他 GHA) 能 够 提供 问题 的 解决 万 案 ， 甚 至 可 能 因为 你 而 修改 OS。 


DTS 不 是 内 部 技术 的 看 门人 。 几 乎 每 个 有 管 案 的 问题 都 有 (或 者 将 会 有 ) 一 个 公共 的 答案 。 你 得 到 的 将 会 是 一 个 沟通 技术 民 
好 、 有 丰富 基础 知识 且 能 回答 特定 问题 的 开发 者 。 
网 站 和 博客 


对 于 参考 相关 的 问题 ， 首 先 要 查看 的 位 置 是 http://developer.apple.com， 这 是 Apple Developer Programs 的 网 站 。 其 中 包含 任 
何 你 会 在 Xcode 的 文档 包 中 找到 的 内 容 ， 而 且 还 包含 很 多 文档 、 可 下 载 的 示例 、 商 业 资 源 、 屏 幕 截 图 ， 以 及 进入 iOS、OS XF 


Safati 开 发 者 页 面 的 入 口 。 获 得 Apple 官 方 信息 的 一 个 好 方法 就 是 将 搜索 限制 在 site:developer.apple.com。 


` 你 如 果 发 现 了 Apple 软 件 的 bug， 或 者 想 要 一 个 新 功能 ， 请 到 这 个 页 面 http://bugrepott.apple.com (你 需要 注册 为 Apple 开 发 
者 ， 免 费 的 即 可 ) 。 请 确保 填写 了 完整 的 报告 (Apple 会 为 你 提供 指引 ) 。 如 果 你 想 要 获得 一 个 新 功能 ， 那 么 请 提供 详实 的 案例 
说 明 这 个 功能 如 何 改进 了 你 的 产品 或 者 工作 流 。 


- Https://developer.apple.com/bug-reporting/ 将 会 向 你 展示 相关 细节 。 


- Apple 有 一 个 Swift 的 官方 博客 : https://developer.apple.com/swift/blog/。 打 开 一 个 月 更 新 一 次 ,但 是 更 新 的 内 容 包 含 很 多 细 
节 ， 当 然 ， 也 很 权威 。 





它 是 针对 iOS 和 OS XUI 组 件 的 信息 收集 地 。 当 我 撰写 本 书 的 时 候 ， 它 的 分 类 中 列 出 了 


- Https://www.cocoaconttols.com 
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- NSHipster，http://nshipstet.com/ ， 它 是 一 个 每 周 更 新 的 博客 overlooked bits in Objective-C，Swift 和 Cocoa。 每 篇 文章 都 调查 


了 Cocoa 编 程 的 一 个 方面 一 一 #ptagma 指 令 ，UICollectionView 同时 精简 为 简明 可 访问 的 介绍 。 带 有 一 点 点 讽刺 意味 。 





- 在 Swift 标准 库 的 playground 或 者 Swift 源 代 码 中 输入 impott Swift 就 能 得 到 接口 的 注释 列表 。 一 页 大 概 有 10000 
行 。http://swiftdoc.ofg 中 有 一 个 经 过 整理 组 织 的 版 本 。 


- Mike Ash 的 Friday Q&A 博 客 涵 盖 了 iOS 和 OS X 相 关 的 问题 ， 这 些 问 题 都 有 一 定 的 深度 和 广度 。 博 客 本 身 (持续 更 新 中 ， 跟 
你 想象 的 差不多 ， 一 周一 次 ) 在 这 里 : http://www.mikeash.com/pyblog/。 你 也 可 以 买 这 个 博客 的 电子 版 本 ， 在 这 
里 : http://www.mikeash.com/book.html。 请 为 他 的 博客 内 容 付费 ， 这 是 他 应 得 的 。 


- GitHub 中 有 很 多 示例 代码 项 目 。 在 搜索 引擎 中 添加 ios sample code github (或 者 os x， 或 者 cocoa 替 换 iDOS) ， 闲 最 的 时 候 可 
以 看 看 。 


面对面 


与 一 位 有 经 验 的 开发 这 坐 下 来 交谈 ， 探 讨 下 如 何 完成 你 想 要 的 工作 ， 可 以 让 你 更 快 地 步 入 正轨 ， 这 比 你 看 很 多 书 (不 包括 这 
本 ) 都 有 用 。 全 世界 有 很 多 用 户 组 ， 你 可 以 在 那里 得 到 帮助 并 且 也 可 以 在 那里 分 享 你 的 经 验 ; 也 有 一 些 课程 能 让 你 加 速 学 习 的 速 
度 。 

会 议 
CocoaHeads，http://cocoaheads.org/， 它 是 Cocoa 程 序 员 国 际 联盟 的 用 户 组 。 在 世界 范围 内 有 大 于 100 个 城市 每 周 都 有 


会 议 。 网 站 依赖 于 每 个 组 保持 信息 的 更 新 ; 我 的 本 地 组 大 概 已 经 有 两 年 没 更 新 了 。 你 仍然 可 以 使 用 这 个 列表 交互 。 


NSCoder Night 更 像 是 运动 而 不 是 用 户 组 ; 它 没有 中 心 (非常 少 的 本 地 ) 组 织 者 。Cocoa 程 序 员 通常 每 周 都 会 聚集 在 公共 
地 点 或 者 咖啡 馆 共 享 他 们 的 经 验 和 代码 。 这 种 集会 发生 在 世界 上 将 近 60 个 城市 。 不 舞 的 是 ， 它 的 网 站 自从 2011 年 开始 就 没有 更 
新 了 ， 同 时 指向 wiki 的 链接 也 成 了 死 链 。Google NSCodernight your city， 在 用 户 组 或 者 学 校 中 询问 ， 如 果 没 有 结果 ， 那 么 你 
束 友 起 一 个 好 了 。 


VATE 


有 很 多 公司 和 教育 机 构 都 会 教 你 Cocoa 编 程 。 我 将 会 介绍 两 个 比较 好 的 ， 其 中 一 个 比较 高 端 ， 另 外 一 个 稍微 基础 些 ,但 是 检 
查 你 本 地 的 学 校 ， 你 可 能 会 很 尺 讶 。 


Stanford University,CS93，Developing Apps for iOS， 这 个 课程 Tunes U 中 有 ， 网 址 
fe: https://itunes.apple.com/us/course/developing-ios-7-apps-for/\penalty- 


\@M%toendlongline~comp.id733644550, 
有 20 个 课时 ， 由 Stanford University 的 Computer science 部 门 授课 。 


Big Nerd Ranch， 网 址 是 : http://bignerdranch.com/,AaronHillegass 的 培训 公司 ， 它 提供 了 按照 星期 计算 的 培训 课程 ， 
包括 OS X, iOS, Cocoa, Rails, AndroidLAROpenGL, 授课 地 点 在 North America 和 Europe。 费 用 ($3500 起 ) 中 包含 了 食 
宿 以 及 往返 机 票 。 


其 他 软件 


Xcode 工 具 集合 并 没有 涵 善 所 有 的 功能 。 由 一 些 工 作 它 们 融 无 法 胜任 。 这 一 部 分 将 会 介绍 一 些 让 你 的 开 有 工作 更 轻松 的 工 


这 里 有 更 多 需要 考虑 的 问题 : 你 将 会 使 用 任何 数量 有 效率 的 工具 来 提升 效率 ， 并 为 你 的 App 提 供 资 源 (比如 ， 我 推荐 一 个 优 
秀 的 位 图 编辑 器 ) 。 我 只 能 推荐 编程 相 天 的 工具 。 


下 面 提 及 的 价格 都 是 2014 年 未 时 四 舍 五 入 换算 成 美元 的 价格 。 


文本 编辑 器 


Xcode 编辑 器 是 用 来 编辑 的 Cocoa 源 代码 的 机 器 。 它 是 理想 状态 下 文本 编辑 器 的 工作 方式 。 也 许 你 无 法 享用 这 种 理想 的 状 
AX, 可 能 你 更 想 直 接 访问 文本 格式 ， 而 不 是 通过 Xcode 这 种 高 等 级 的 编辑 器 ， 也 需 你 需要 自己 的 工具 来 打造 专属 的 工作 环境 。 


n> 2b 


- BBEdit, EIR Bare Bones Sofeware， 特 别 适 合 编 辑 大 型 文件 和 HTML 文 件 。 它 能 打开 任何 文件 。 它 支持 AppleScript、 


UNIX 肢 本， 以 及 让 宏 更 可 读 。 本 书 就 是 使 用 BBEdit 编 写 而 成 。 直 接 在 Bare Bones 中 就 可 以 找到 这 个 软件 : 
Http://www.barebones.com/products/bbedit-$50, 


名 注意 我 应 该 承认 ，Bare Bones 有 的 时 候 会 给 我 一 些 文档 工作 ， 我 可 以 免费 使 用 BBEdit 11. 我 已 经 伦 快 地 使 用 BBEdit10 多 
年 了 ， 在 Bate Bones 联 系 我 之 前 我 已 经 在 本 书 的 前 几 个 版 本 中 推荐 过 它 很 多 


次 。 


- Bare Bones 提 供 了 一 个 “ 轻 量 级 ”的 BBEdit: TextWrangler。 这 个 版 本 缺少 一 些 BBEdit 扩 展 ， 比 如 网 页 开发 、 文 本 补 全 、 版 


本 管理 支持 、 内 置 的 shell 工 作 表 等 。http://www.barebones.com/products/textwrangler/ 这 个 版 本 免费 。 


- TextMate 2 beta， 它 源 于 MactoMates， 是 一 个 具有 丰富 自 定义 功能 的 编辑 器 。 语 法 配色 功能 和 强大 的 快捷 方式 适用 于 多 种 


语言 和 应 用 程序 。TextMate 有 一 个 活跃 的 用 户 社区 ,很 多 使 用 格式 化 文本 的 开发 者 都 提供 了 免费 版 本 的 TextMate 扩 展 bundles。 


2012 年 8 月 将 源 代码 
$50 (39 欧 元 ) 。 


. TextMate 2 在 2009 年 的 时 候 声明 “90% 的 完整 性 ”。 在 2011 年 发 布 了 pre alpha 版 本 ， 吸 引 了 不 少 粉丝 。 
发 布 在 GNU General Public License 下 。 你 购买 一 个 当前 版 本 的 许可 ， 支 持 版 本 在 http://mactomates.com 





- Sublime Text 2 是 一 个 适用 于 Mac、Windows 和 Linux 的 GUI 编辑 器 。 你 可 以 使 用 基于 JSON 的 脚本 和 Python 插件 自 定 义 它 的 功 
能 。 它 能 识别 多 种 语言 的 语法 ， 并 且 能 够 索引 源 代 码 和 库 文 件 代 码 。 多 个 选择 允许 你 同时 编辑 常见 的 字符 串 。 据 说 Sublime Text 
很 感 兴趣 ， 发 现 了 其 中 的 Text Mate bundle。http://www.sublimetext.com 





$59 。 


` 每 个 标准 安装 的 OS X 都 提供 了 emacs 和 vi。 如 果 你 有 任何 命令 行 的 使 用 背景 ， 那 么 你 
并 且 想 要 尝试 另外 一 个 。 


可 能 知道 如 何 使 用 其 中 的 一 个 工具 ， 


` 两 者 都 有 图 形 化 的 版 本 。 查 看 XEmacs，www.xemacs.org， 它 是 Windows 版 本 的 emacs。MacView 是 vi 家 族 最 流行 的 Mac 原 生 
的 图 形 化 编辑 器 ， 可 以 在 http://code.google.com/p/macvim/ 中 找到 源 代码 和 对 应 的 安装 文件 。Vico，http://www.vicoapp.com 是 带 
有 vi 快捷 键 绑 定 的 编辑 器 ， 它 可 以 使 用 TextMate 语 言 包 。 这 些 都 是 免费 软件 。 


有 很 多 很 多 Cocoa 开 发 者 的 支持 工具 一 一 人 在 Mac App store 中 勾 选 Developer Tools 分 类 就 能 看 到 可 用 的 工具 。 下 面 列举 了 


ve 727 


- Dash 标 榜 自 己 是 一 个 “文档 浏览 器 和 代码 片段 管理 器 
Rails、Java、jQuery、Atduino 等 的 引用 。 这 个 应 用 程序 内 置 了 一 个 搜索 接口 ， 它 可 以 让 你 匹配 所 有 活动 的 文档 集合 ; CRAIN 
建 一 个 项 目 需 要 的 文档 集合 的 特定 任务 组 。 选 择 一 个 页 面 (比如 ，Cocoa 类 引用 页 面 ) ， 然 后 这 个 页 面 上 所 有 的 分 类 和 条 目 都 会 


在 窗口 的 左边 显示 为 一 个 方便 的 索引 。 


。 你 可 以 从 Cocoa 文 档 集 开始 ， 但 是 你 可 以 添加 相当 数量 的 Ruby on 


. 代码 片段 管理 器 能 管理 很 多 种 语言 的 代码 。 选 择 一 种 语言 ， 然 后 触发 Dash 服 务 。 选 中 的 代码 片段 将 会 显示 在 弹出 窗口 中 ， 
这 样 你 就 可 以 编辑 占 位 符 了 。 它 比 Xcode 更 智能 ， 因 为 编辑 一 个 占 位 符 ， 就 能 更 改 其 他 与 之 匹配 的 相同 占 位 符 。 按 下 tetutfn 键 粘贴 





完整 的 代码 。Dash 完 成 了 很 多 工作 ， 它 可 以 让 一 个 未 经 训练 的 用 户 能 更 方便 地 使 用 
5| 


同时 它 也 提供 了 提示 (可 以 关闭 提示 ) 指 


整 
基本 的 使 用 方法 。Http://kapeli.com/dash 和 Mac 应 用 商店 都 可 以 找到 这 个 软件 。 免 费 下 载 ， 完 整 版 需要 10$。 


. Hopper Disassembler， 在 第 5 章 中 ， 我 曾经 使 用 它 生成 一 个 编译 过 的 c 咬 数 的 伪 代 码 。 如 果 你 需要 一 个 用 于 分 析 的 反 汇编 纺 


辑 器 ， 那 要 么 是 为 了 优化 ， 要 么 是 怀疑 有 编译 器 bug。 无 论 怎样 ， 你 可 能 都 会 使 用 这 个 工具 。 


- App 都 是 编译 过 的 代码 ， 它 是 比特 流转 化 的 数据 ， 动 态 链接 的 跳 转 表 以 及 代码 的 最 佳 展 示 ， 它 们 都 会 分 解 函数 和 子 模 块 。 
然后 需要 你 在 转化 为 机 器 码 的 过 程 中 纠正 组 合 问 题 并 重 命名 对 象 〈 包 括 定 义 本 地 变量 的 栈 偏 移 ) o 


正如 你 所 见 ，Hoper 为 你 提供 了 伪 代 码 ， 它 很 适合 用 来 显示 并 解决 你 心中 的 疑问 。 
` 它 与 调试 器 挂 钓 ， 宣 传 材料 说 它 使 用 的 是 gedb， 但 是 我 们 希望 ldb 也 能 使 用 。 


. 它 的 开发 者 (我 觉得 他 是 一 位 非常 有 耐心 的 人 ) 按照 他 自己 的 需要 设计 了 UI。 应 用 程序 原本 打算 使 用 键盘 ,使 用 字符 
(不 是 Command 键 ) 命令 。 需 要 花费 一 些 时 间 来 适应 ， 不 过 也 很 容易 。 


* 开发 者 页 面 上 有 一 个 功能 受 限 的 演示 版 本 ，http://www.hopperapp.com。 从 开发 者 那里 直接 购买 需要 花费 $89。 


Kaleidoscope 是 最 高 等 级 的 文本 对 比 和 合并 编辑 器 。 当 你 第 一 次 使 用 它 的 时 候 ， 你 就 会 发 现 它 是 一 个 美化 版 的 差异 对 比 工 
有 具 一 一 它 显 示 了 两 个 文件 的 不 同 ， 与 Xcode 的 对 比 编辑 器 没有 多 大 的 差异 。 但 是 Xcode 对 比 编辑 器 只 有 一 种 使 用 方式 ， 接 受 或 者 
拒绝 一 个 文件 两 个 版 本 之 间 的 差异 ; 它 是 一 个 合并 工具 。 开 aleidoscope 能 让 你 将 分 散 的 文本 行 从 一 个 文件 中 复制 到 另外 一 个 文件 


中 。 所 以 它 是 一 个 通用 的 合并 工具 。 它 可 以 集成 到 Versions、SourceTree 以 及 svn 和 git 命 令 行 中 。 
“ 它 还 包含 整个 目录 。 如 果 你 有 一 个 文件 的 两 个 版 本 ， 那 么 你 可 以 将 它们 两 个 排序 ， 这 样 就 能 选择 任意 两 个 比较 。 
还 能 对 比 图 片 ， 为 你 提供 翻转 对 比 ， 分 拆 视图 或 者 位 图 中 更 改 的 像素 。 
- 这 就 是 为 什么 它 值 70$。 在 http://www.kaleidoscopeapp.com 和 Mac App Store P # T AFTR, 70$. 


- Mogeneratot 一 一 在 第 8 和 草 中 ， 我 向 你 展示 了 Xcode 的 Data Model 编 辑 器 虽然 能 从 数据 模型 中 生成 NSManagedObject 子 类 ， 但 是 


使 用 mogenetatot 能 得 到 更 好 的 效果 。 这 里 不 黄 述 它 的 优点 ， 只 管 使 用 就 好 。 


PIER ”mogenerator 包 含 了 xmod 插 件 ，Xcode 3 可 以 监控 你 的 数据 模型 文件 ， 并 自动 重新 生成 机 器 使 用 的 类 。 不 幸 的 是 ， 从 
Xcode 4 开始 ， 这 个 插件 不 见 了 。 


- PaintCode 非 常 酷 。 第 一 眼看 到 它 的 时 候 ， 它 是 一 个 基于 向 量 的 绘制 应 用 ， 带 有 各 种 特性 。 你 可 以 通过 名 字 定 义 颜 色 这 一 
点 很 有 趣 ， 基 于 纯色 定义 其 他 颜色 ， 同 时 还 能 通过 定义 的 颜色 生成 渐进 色 。 如 果 你 有 一 个 图 形 填 充 了 命名 的 渐进 色 ， 那 么 更 改 基 
而 颜色， 继承 颜色 和 渐进 颜色 都 会 发 生 相 应 的 更 改 与 之 匹配 。 


事实 上 它 是 一 个 代码 编辑 器 。 当 你 构建 绘制 的 时 候 ，PaintCode 会 生成 Swift、Objective-C 或 者 C# 代 码 ， 重 新 生成 绘制 过 
程 。 它 包含 表达 式 编 辑 器 ， 用 于 计算 边界 值 和 偏 移 ， 同 时 变量 可 以 作为 本 地 或 者 函数 参数 编码 。 我 很 少 使 用 PaintCode 的 代码 更 





改 功能 ， 但 是 它 的 确 节约 了 我 半天 的 时 间 ， 让 我 得 到 正确 的 弧度 。Http://www.paintcodeapp.com 一 一 从 Mac 应 用 商店 中 下 载 需 要 
$100. 
包 管 理 器 

Xcode 中 有 很 多 工具 可 以 用 来 构建 免费 和 开源 的 软件 (FOSS) 。 ， 即 便 你 拥有 从 头 开始 的 一 切 工 具 ， 你 也 没有 时 间 搜 


系 库 之 间 的 依赖 以 及 让 它们 正 弟 运作 的 构建 选项 。 这 惑 是 为 什么 大 多 数 操 作 系 统 和 大 多 数 脚本 语言 都 市 有 包 管 理 器 ， 它 能 处 理 所 
有 的 细节 问题 ， 你 只 需要 天 心目 己 的 工作 残 好 。 


OS X 没 有 提供 包 管 理工 具 ， 但 是 有 4 个 志愿 者 的 社区 项 目 提供 了 管理 软件 ， 并 移植 了 很 多 FOSS 的 包 。 大 多 数 都 能 在 命令 行 
下 工作 ; 最 简单 的 情况 下 ， 你 只 需要 调用 管理 器 的 命令 行 (fink, brew, port, pod) ， 还 有 图 形 化 的 包 妆 器 


第 三 方 的 包 管 理 器 有 个 问题 区 是 它们 不 是 系统 上 安 疼 软 件 的 唯一 机 制 。 如 果 你 目 己 运行 一 个 makefile 文 件 ， 或 者 打开 一 个 


安装 包 安 闭 上 自己 的 组 建 ， 甚 全 使 用 另外 一 个 包 管 理 器 ， 安 凌 的 产品 将 会 相互 影响 。 每 个 管理 器 都 有 它 上 自己 保护 产品 的 策略 。 
. Fink 是 最 先 出 现 的 ， 它 建立 与 2000 年 。 它 是 由 Debian 中 类 似 于 aptrget 这 样 的 包 管 理工 具 演变 而 来 。 构 建 产 品 会 进入 /sw 目 
你 必须 通过 源 代码 构建 。 安 装 指 引 中 的 可 用 平台 包含 PowerPC， 如 


录 。Fink 从 OS X10.5 开 始 就 已 经 不 再 提供 二 进 制 安 装 文件 了 ， 
一 个 好 消息 


果 你 仍然 在 使 用 PPC Mac 机 器 (我 在 我 的 PowerMac G4，2000-2013 上 安装 成 功 了 ) , PARE 
Http://fink.thetis.ig42.org 
台 信 息 组 成 ， 搜 索 栏 特别 


Cocoapods 专 门 用 于 Objective-C 项 目 。 客 户 端 软件 作为 cocoapods Ruby gem 发 布 。 网 站 由 
息 > 增 量 搜索 就 会 显示 


大 ， 你 可 能 都 不 会 注意 它 是 搜索 栏 (顶部 的 红色 SEARCH*) 。 输 入 作者 、 名 字 、 关 键 字 和 其 他 相关 的 从 


\ 


W 


匹配 的 pods 。 


Http://cocoapods.org 


- Homebrew， 被 誉 为 “OS 叉 平 台 上 丢失 的 包 管 理 器 ”， 它 是 最 新 的 包 管 理 器 。 基 于 Ruby 和 Git， 它 很 干净 ， 很 多 新 项 目 都 将 


它 作 为 分 发 方式 。 构 建 的 产品 会 放 到 主 目录 下 的 homebrew 文 件 夹 中 ， 然 后 从 /usrt/local 中 链接 它们 。 


http://brew.sh, 
还 带 有 Darwin， 那 个 时 候 Darwin 还 是 一 个 很 有 竞争 力 的 


包 。 MacPortts 树 的 根 节点 


- MacPorts (以 前 的 DarwinPorts) 已 经 很 有 年 头 了 ， 之 前 它 的 名 字 中 还 


开源 UNIX 版 本 。 这 个 项 目 尽 量 保证 它 的 包 与 当前 的 OS X 版 本 相 匹 配 。 它 的 库 中 大 概 有 18000 个 


在 /opt/mports.http://www.macpotrts.orgo 


版 本 管理 
就 像 第 7 草 介 绍 的 那样 ， 版 本 管理 是 一 个 很 庞大 的 话题 ， 有 很 多 细节 问题 ， 面 向 系统 的 命令 行 接口 非常 繁杂 。 我 之 前 推荐 阅 


iz (Pro Git》 和 《Version Control with Subversion》 作 为 最 好 的 命令 行 工 具 指引 。 


Xcode 的 源 代码 管理 工具 将 你 从 泥沼 中 解放 出 来 ， 但 是 很 多 开 上 友 痢 友 现 他 们 仍然 有 很 多 问题 ， 或 者 需要 更 多 Xcode 没 有 提供 


的 功能 一 一 标签 功能 束 是 最 强烈 的 需求 。 
最 想 要 用 一 种 简单 的 万 式 来 使 用 版 本 管理 系统 的 人 残 是 程序 员 了 。 他 们 有 目 己 的 市 场 ， 
管理 系统 。 数 量 实在 太 多 ， 这 里 无 法 全 部 列举 。 





这 样 残 促 生 了 大 量 功 能 完备 的 源 代码 


下 面 是 一 些 比较 出 色 的 : 

. Git 本 身 来 源 于 管理 仓库 的 跨 平 台 工 具 。 在 我 使 用 SourceTree 之 前 ，gi 代 是 我 最 喜欢 的 用 于 可 视 化 代码 仓库 结构 的 命令 ， 它 
能 让 你 在 命令 行 中 启动 。 它 为 你 提供 了 版 本 对 比 功能 以 及 直接 前 驱 。 如 果 安 装 了 Xcode， 就 会 免费 安装 所 有 的 Git 工 具 。 
- SourceTree， 来 自 于 Atlassian， 它 是 一 个 被 交口 称 鞠 且 广 泛 使 用 的 Git 和 Mercurial 仓 库 管理 工具 。 当 你 第 一 次 启动 的 时 候 ， 首 
先 要 提供 远程 仓库 的 认证 信息 ， 它 会 扫描 你 的 目录 查找 代码 仓库 ， 并 询问 你 想 要 管理 那些 代码 仓库 。 
` 它 的 UI 有 点 复杂 ， 工 具 栏 上 有 19 个 空间 。 但 是 全 面 管理 Git 仓 库 是 一 项 非常 坏 手 的 任务 几 分 钟 后 ， 界 面 就 可 以 使 用 


了 。 和 忽略 第 24 章 介绍 的 doc 目 录 ， 这 需要 几 次 匀 选 ; 它 的 功能 很 容易 找到 。 


它 兼 容 OS 又 10.6 及 以 上 版 本 。Atlassian 提 供 了 自己 的 云 软件 管理 服务 ， 包 括 Bitbucket， 它 是 一 项 最 多 有 5 个 免费 协作 者 的 


as 


服务 器 


O 〇 


Http://www.sourcetreeapp.com 


- GitHub 是 公开 Git 仓 库 的 主要 提供 商 。 它 提供 了 简单 的 管理 接口 ， 能 够 显示 版 本 差异 和 分 支 。 它 专注 于 让 你 的 项 目 和 远程 
代码 仓库 (GitHub 中 的 仓库 ) 保持 实事 同步 。GitHub 致 力 于 制作 提供 简单 强大 的 接口 的 App。 这 一 点 没有 错 ， 它 做 得 也 非常 
好 。Http://mac.github.com。 应 用 本 向 免费 。 


Versions 是 OS 义 系 统 上 领先 的 Subvetsion 客 户 端 ， 它 的 UI 设计 赢得 过 Apple Design 奖 。 它 提供 了 非常 实用 的 服务 一 一 版 本 对 





比 、 提 交 、 分 支管 理 等 ， 它 使 用 内 置 实 现 的 Subversion1.7 与 Subversion 代 码 仓 库 进 行 通信 一 一 无 需 安 装 其 他 软件 ， 也 不 用 担心 app 
和 系统 安装 的 svn 版 本 不 匹配 。 





$59， 学 生 购 买 $39， 有 30 天 的 试用 版 本 。 


- http:/ /www.versionapp.com 


AppCode 


JetBrainsAppCode 是 针对 iOS 和 OS X 开 上 友 的 免费 IntellJ 1DE 的 进化 。 它 的 重 构 功能 大 大 强 于 Xcode， 它 的 代码 分 析 功 能 5 
以 完成 很 多 工作 ， 从 纠正 注释 中 的 符号 拼写 错误 到 检查 无 效 的 万 法 ， 到 提供 使 用 了 未 定义 的 浮 数 和 方法 的 实现 ， 以 及 目 动 测试 
等 。 它 是 一 个 检查 代码 的 机 器 。 如 果 这 是 你 优先 考虑 的 问题 ， 那 么 可 以 先 尝 试 示例 版 本 。 它 包含 clang 的 藤 入 构建 用 于 静态 分 
析 ，lldb 用 于 调试 ， 还 有 几 个 单元 测试 系统 ， 包 括 XCTest。 


Xcode 仍 然 有 很 多 优点 。 它 的 版 本 管理 工具 非常 适合 在 日 常 工作 中 使 用 。 它 还 有 一 个 优秀 的 调试 器 。 它 支持 系统 继承 并 能 减 
轻 单元 测试 ， 分 析 和 beta 友 布 的 痛 兰 。 它 还 有 一 个 Interface Builder; AppCode 有 一 个 UI Designer， 能 处 理 storyboard 和 
XIB， 但 是 它 需要 回 退 最 新 版 本 Xcode 生成 的 格式 。AppCode 无 法 完成 iOS 友 布 。AppCode 能 处 理 Xcode 项 目 ， 但 是 Xcode 仍然 
是 创建 Xcode 项 目的 最 佳 工 具 。 所 以 使 用 AppCode 的 开发 者 通常 会 将 它 作 为 Xcode 的 补充 ， 而 不 是 作为 主要 的 1DE。 即 便 是 
Xcode 狂热 分 子 (如 果 有 ) 也 应 该 尝试 下 AppCode， 这 样 Xcode 才 有 动力 继续 前 进 。 


它 有 4 种 许可 ， 包 括 $99 的 个 人 使 用 许可 和 $199 的 组 织 许 可 ， 还 有 教育 使 用 的 免费 许可 。Http://www.jetbrains.com/objc/ 
Cocoa 的 替代 品 
本 书 介绍 的 是 Xcode 的 使 用 ， 附 带 还 介绍 了 Cocoa， 但 是 它 有 一 些 替 代 产 品 。 你 可 以 自行 研究 一 下 。 


Titanium 和 PhoneGap 都 是 跨 平台 的 移动 应 用 框架 ， 包 括 iOS。 它 们 都 是 用 JavaScript 编 写 。 它 们 标记 了 本 地 库 ， 可 以 访问 
诸如 GPS、 加 速 器 以 及 相机 等 功能 。 这 两 个 都 是 开源 框架 ， 有 来 自 市 公司 的 支持 一 一 Adobe 为 PhoneGap 提 供 支 


持 ，Appcelerator 为 Titanium 提 供 支 持 。 


你 还 是 需要 iOS Developer Program 关 系 才 能 在 设备 上 运行 App。 


Adobe PhoneGap 


开 友 PhoneGap 应 用 程序 的 时 候 ， 你 可 以 使 用 最 方便 的 网 页 构建 工具 ， 比 如 Adobe Dreamweaver。UI| 实 现 主要 通过 HTML 
5 和 CSS。 编 程 语言 是 JavaScript。 想 要 测试 App， 需 要 回 到 Xcode 构建 ， 并 在 iOS 模 拟 器 中 运行 。 PhoneGap 应 用 程序 由 本 地 应 
用 包装 ， 将 App 褒 入 UIWebView (iOS) 中 。 


PhoneGap 最 大 的 优点 在 于 : 它 是 一 个 “一 次 编写 ， 到 处 运行 ”的 开发 工具 。 它 自身 局 限于 目标 设备 都 有 的 功能 (因为 各 个 
平台 上 的 浏览 器 不 同 ， 虽 然 很 多 都 使 用 WebkKit) ， 而 不 能 使 用 平台 独 有 的 特性 。HTML 和 本 地 代码 之 间 的 通信 通过 一 个 
JavaScript 通 道 (面向 HTML 问 ) 和 一 个 特定 的 URL scheme (面向 “真正 的 ”App) 。 


http://phonegap.com 一 一 它 是 开源 软件 ,不 收费 。 主 要 的 支持 和 培训 | 通过 “企业 ”服务 。 


有 一 本 相关 的 书籍 : Shotts，Kerri 编 写 的 《PhoneGap 3.x Mobile Application Development(2014)》。 


Appcelerator Titanium 


Titanium 的 野心 非常 大 。 平 台中 通用 的 内 容 由 通用 的 Titanium API 提 供 ， 但 是 它 也 提供 平台 特定 的 库 ， 所 以 你 可 以 接受 本 
地 代码 视图 和 UI 约定 。1DE 使 用 Titanium Studio， 它 基于 Eclipse， 使 用 Xcode (针对 iOS) 完成 构建 和 安装 。 


Titanium 应 用 程序 的 代码 是 Javascript， 但 是 App 运 行 的 时 候 (BA) 不 基于 它 。 构 建 过 程 中 ， 会 将 Js 代码 转化 为 
Objective-C(iOS) 人 代码， 然后 再 编译 成 应 用 程序 。App 中 仍然 包含 一 个 Javascript 解 释 器 ， 用 来 处 理 只 有 Js 才 有 的 语言 特性 一 一 
这 也 是 App 获 得 Js 提供 的 动态 机 制 的 来 源 。 它 使 用 这 种 方法 完成 本 地 代码 的 调用 ， 由 此 实现 了 你 的 应 用 程序 。 很 聪明 的 做 法 。 


Titanium Ul 通过 JavaScript 襄 明文 档 构 建 。 独 立 开 发 者 使 用 接口 构建 工具 ， 但 是 在 我 撰写 本 书 的 时 候 ， 还 没有 Titanium 
studio。 你 可 以 构建 HTML 视 图 ， 但 是 HTML 视 图 并 非 是 Titanium 的 原生 形式 。 你 只 是 将 HTML 源 代码 放 到 网 页 视图 中 ， 它 才 是 
Titanium 真 正 关心 的 视图 。 对 于 原生 组 件 一 一 导航 栏 、 按 钮 一 一 Titanium 提 供 了 原生 对 象 ， 而 不 是 一 点 都 不 像 的 图 片 。 


http://www.appcelerator.com/ 一 一 开源 软件 ， 不 收费 。 支 持 和 培训 收费 。 


Brousseau，Christian 编 写 了 《Creating Mobile Apps with Appcelerator Titanium(2013)》。 


市 有 偏见 性 的 评估 


10 多 年 原生 应 用 开发 者 的 意见 : 可 替代 框架 应 该 占有 一 席 之 地 ， 但 是 不 要 抱 有 太 多 希望 。 如 果 开 发 in-house 应 用 程序 ， 你 
通 党 会 寻找 完成 所 定 功能 性 价 比 最 高 的 解决 方案 ， 而 不 用 寄 希 望 于 一 个 提供 商 ， 也 不 用 满足 外 部 市 场 的 需求 。 一 次 编写 、 到 处 运 
行 (WORA) 是 一 个 合理 的 选择 。 


但 是 ， 在 商业 产品 中 ， 这 是 一 个 非 弟 糟 糕 的 策略 。 人 们 人 花 大 价钱 购买 了 iPhone (或 者 Nexuses) ， 他 们 想 在 App 中 体验 最 
新 的 功能 。 非 原生 的 应 用 永远 都 不 能 保持 新 功能 的 同步 更 新 ， 原 生 应 用 就 有 上 市 时 间 的 优势 。 只 能 相信 WORA app 可 以 负担 起 
某 一 个 平台 ， 同 时 付费 用 户 还 不 关心 新 功能 。WORA 工 具 和 任何 现代 应 用 框架 类 似 一 一 它们 可 以 制作 出 看 上 去 很 不 错 的 原型 产 
品 ， 而 且 运 行 得 也 很 流畅 。 然 后 将 剩余 的 95% 的 开 上 友 精 力 放 在 能 收费 的 功能 上 。 不 过 将 人 花费 数 月 在 平台 特定 的 问题 上 面 (即便 都 
是 WebKit， 不 同 的 手机 上 也 有 些 不 同 ) 。 到 那 时 ， 性 能 将 会 是 一 个 非 昔 严重 的 问题 : Facebook 的 Mark Zuckerberge 将 
HTML-only 的 开 上 友 称 为 “公司 做 出 的 最 大 错误 ”。 


即便 对 于 in-house 开 发 ， 你 也 要 问 自己 这 个 问题 : 你 依赖 一 个 BYOD (bring your own device) 政策 。 用 户 是 因为 App 的 
可 移植 性 ， 还 是 因为 在 这 些 设备 上 能 快速 、 高 效 、 容 易 操 作 App 而 选择 购买 iPhone 和 iPad (还 有 Nexuse) W? 如 果 是 后 者 ， 那 
么 应 该 集中 精力 在 其 他 应 用 上 ，WORA 可 能 只 是 一 种 浪费 金钱 的 行为 。 


这 两 个 框架 都 吸引 了 那些 避免 学 习 原 生 API 和 (针对 iOS) 新 语言 的 开 友 者 。 这 样 做 是 本 末 倒 置 : 虽然 你 不 再 学 习 数 量 庞大 
的 API， 但 是 暴露 的 API 数 量 很 少 ， 它 反映 了 你 无 法 访问 平台 相 天 的 特性 。 跨 平台 的 框 滋 是 不 同 平台 的 集合 ， 如 果 仅 仅 将 网 页 开 
上 友 者 放 到 大 型 移动 项 目 中 ， 而 不 进行 长 时 间 的 系统 学 习 ， 融 奢 扭 做 出 成 功 的 项 目 ， 那 么 希望 很 可 能 会 洛 空 。 


